home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / colorls2.zip / ls.cat < prev    next >
Text File  |  1996-02-29  |  16KB  |  391 lines
  1.  
  2.  
  3. LS(1L)                     Unix Programmer's Manual                     LS(1L)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      ls, dir, vdir - list contents of directories
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      lllsss  [-abcdefgiklmnopqrstuxABCFGLNQRSUX178]  [-w  cols]  [-T   cols]   [-I
  11.      pattern]   [--all]   [--escape]   [--directory]  [--inode]  [--kilobytes]
  12.      [--numeric-uid-gid]   [--no-group]   [--hide-control-chars]   [--reverse]
  13.      [--size]   [--width=cols]   [--tabsize=cols]   [--almost-all]  [--ignore-
  14.      backups]  [--classify]  [--file-type]  [--full-time]   [--ignore=pattern]
  15.      [--dereference]       [--literal]       [--quote-name]      [--recursive]
  16.      [--sort={none,time,size,extension}]
  17.      [--format={long,verbose,commas,across,vertical,single-column}]
  18.      [--time={atime,access,use,ctime,status}]         [--color[={yes,no,tty}]]
  19.      [--colour[={yes,no,tty}]] [--unix] [--help] [--version] [name...]
  20.  
  21. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  22.      This manual page documents the GNU version of lllsss, with color  extensions.
  23.      dddiiirrr  and  vvvdddiiirrr  are versions of lllsss with different default output formats.
  24.      These programs  list  each  given  file  or  directory  name.   Directory
  25.      contents  are sorted alphabetically.  For lllsss, files are by default listed
  26.      in columns, sorted vertically, if the  standard  output  is  a  terminal;
  27.      otherwise  they  are  listed one per line.  For dddiiirrr, files are by default
  28.      listed in columns, sorted vertically.  For vvvdddiiirrr,  files  are  by  default
  29.      listed in long format.
  30.  
  31.      OOOPPPTTTIIIOOONNNSSS
  32.  
  33.      -_a, --_a_l_l
  34.           List all files in directories, including all files that  start  with
  35.           `.'.
  36.  
  37.      -_b, --_e_s_c_a_p_e
  38.           Quote nongraphic characters in file names using alphabetic and octal
  39.           backslash sequences like those used in C.
  40.  
  41.      -_c, --_t_i_m_e=_c_t_i_m_e, --_t_i_m_e=_s_t_a_t_u_s
  42.           Sort directory contents according to the files' status  change  time
  43.           instead  of  the  modification  time.  If the long listing format is
  44.           being used, print the status change time instead of the modification
  45.           time.
  46.  
  47.      -_d, --_d_i_r_e_c_t_o_r_y
  48.           List  directories  like  other  files,  rather  than  listing  their
  49.           contents.
  50.  
  51.      -_e, --_f_u_l_l-_t_i_m_e
  52.           List times in full, rather  than  using  the  standard  abbreviation
  53.           heuristics.
  54.  
  55.      -_f   Do not sort directory contents; list them in whatever order they are
  56.           stored  on  the  disk.  The same as enabling -_a and -_U and disabling
  57.           -_l, -_o, -_s, and -_t.
  58.  
  59.      -_g   Ignored; for Unix compatibility.
  60.  
  61.  
  62.  
  63.  
  64.                              GNU File Utilities                              1
  65.  
  66.  
  67.  
  68. LS(1L)                     Unix Programmer's Manual                     LS(1L)
  69.  
  70.  
  71.      -_i, --_i_n_o_d_e
  72.           Print the index number of each file to the left of the file name.
  73.  
  74.      -_k, --_k_i_l_o_b_y_t_e_s
  75.           If file sizes are being  listed,  print  them  in  kilobytes.   This
  76.           overrides the environment variable PPPOOOSSSIIIXXXLLLYYY___CCCOOORRRRRREEECCCTTT.
  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  type,
  80.           permissions,  number  of hard links, owner name, group name, size in
  81.           bytes, and timestamp (the modification time unless other  times  are
  82.           selected).   For files with a time that is more than 6 months old or
  83.           more than 1 hour into the future, the timestamp  contains  the  year
  84.           instead of the time of day.
  85.  
  86.      -_m, --_f_o_r_m_a_t=_c_o_m_m_a_s
  87.           List files horizontally, with as many as  will  fit  on  each  line,
  88.           separated by commas.
  89.  
  90.      -_n, --_n_u_m_e_r_i_c-_u_i_d-_g_i_d
  91.           List the numeric UID and GID instead of the names.
  92.  
  93.      -_o, --_c_o_l_o_r, --_c_o_l_o_u_r, --_c_o_l_o_r=_y_e_s, --_c_o_l_o_u_r=_y_e_s
  94.           Colorize the names of files depending on  the  type  of  file.   See
  95.           `DISPLAY  COLORIZATION'  below.   Note  that  -_o unlike --_c_o_l_o_r is a
  96.           toggle.
  97.  
  98.      -_p   Append a character to each file name indicating the file type.
  99.  
  100.      -_q, --_h_i_d_e-_c_o_n_t_r_o_l-_c_h_a_r_s
  101.           Print question marks instead of nongraphic characters in file names.
  102.  
  103.      -_r, --_r_e_v_e_r_s_e
  104.           Sort directory contents in reverse order.
  105.  
  106.      -_s, --_s_i_z_e
  107.           Print the size of each file in 1K blocks to the  left  of  the  file
  108.           name.   If the environment variable PPPOOOSSSIIIXXXLLLYYY___CCCOOORRRRRREEECCCTTT is set, 512-byte
  109.           blocks are used instead.
  110.  
  111.      -_t, --_s_o_r_t=_t_i_m_e
  112.           Sort directory contents by timestamp instead of alphabetically, with
  113.           the newest files listed first.
  114.  
  115.      -_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
  116.           Sort directory contents according to the  files'  last  access  time
  117.           instead  of  the  modification  time.  If the long listing format is
  118.           being used, print the last access time instead of  the  modification
  119.           time.
  120.  
  121.      -_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
  122.           List the files in columns, sorted horizontally.
  123.  
  124.      -_A, --_a_l_m_o_s_t-_a_l_l
  125.           List all files in directories, except for `.' and `..'.
  126.  
  127.  
  128.  
  129.                              GNU File Utilities                              2
  130.  
  131.  
  132.  
  133. LS(1L)                     Unix Programmer's Manual                     LS(1L)
  134.  
  135.  
  136.      -_B, --_i_g_n_o_r_e-_b_a_c_k_u_p_s
  137.           Do not list files that end with `~', unless they are  given  on  the
  138.           command line.
  139.  
  140.      -_C, --_f_o_r_m_a_t=_v_e_r_t_i_c_a_l
  141.           List files in columns, sorted vertically.
  142.  
  143.      -_F, --_c_l_a_s_s_i_f_y
  144.           Append a character to each file name indicating the file type.   For
  145.           regular  files  that  are  executable,  append a `*'.  The file type
  146.           indicators are `/' for directories, `@' for symbolic links, `|'  for
  147.           FIFOs, `=' for sockets, and nothing for regular files.
  148.  
  149.      -_G, --_n_o-_g_r_o_u_p
  150.           Inhibit display of group information  in  a  long  format  directory
  151.           listing.
  152.  
  153.      -_L, --_d_e_r_e_f_e_r_e_n_c_e
  154.           List the files linked to by symbolic links instead  of  listing  the
  155.           contents of the links.
  156.  
  157.      -_N, --_l_i_t_e_r_a_l
  158.           Do not quote file names.
  159.  
  160.      -_Q, --_q_u_o_t_e-_n_a_m_e
  161.           Enclose file names in double quotes and quote nongraphic  characters
  162.           as in C.
  163.  
  164.      -_R, --_r_e_c_u_r_s_i_v_e
  165.           List the contents of all directories recursively.
  166.  
  167.      -_S, --_s_o_r_t=_s_i_z_e
  168.           Sort directory contents by file size instead of alphabetically, with
  169.           the largest files listed first.
  170.  
  171.      -_U, --_s_o_r_t=_n_o_n_e
  172.           Do not sort directory contents; list them in whatever order they are
  173.           stored  on  the disk.  This option is not called -_f because the Unix
  174.           lllsss -_f option also enables -_a and disables -_l, -_s, and -_t.  It  seems
  175.           useless  and  ugly  to  group those unrelated things together in one
  176.           option.  Since this option doesn't do that, it has a different name.
  177.  
  178.      -_X, --_s_o_r_t=_e_x_t_e_n_s_i_o_n
  179.           Sort directory contents alphabetically by file extension (characters
  180.           after the last `.'); files with no extension are sorted first.
  181.  
  182.      -_1, --_f_o_r_m_a_t=_s_i_n_g_l_e-_c_o_l_u_m_n
  183.           List one file per line.
  184.  
  185.      -_w, --_w_i_d_t_h _c_o_l_s
  186.           Assume the screen is _c_o_l_s columns wide.  The default is  taken  from
  187.           the  terminal driver if possible; otherwise the environment variable
  188.           CCCOOOLLLUUUMMMNNNSSS is used if it is set; otherwise the default is 80.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                              GNU File Utilities                              3
  195.  
  196.  
  197.  
  198. LS(1L)                     Unix Programmer's Manual                     LS(1L)
  199.  
  200.  
  201.      -_T, --_t_a_b_s_i_z_e _c_o_l_s
  202.           Assume that each tabstop is _c_o_l_s columns wide.  The default is 8, or
  203.           whatever the TTTAAABBBSSSIIIZZZEEE environment variable says.  Setting the tabsize
  204.           to 0 disables the use of tab characters completely.
  205.  
  206.      -_I, --_i_g_n_o_r_e _p_a_t_t_e_r_n
  207.           Do not list files whose names match the shell pattern _p_a_t_t_e_r_n unless
  208.           they are given on the command line.  As in the shell, an initial `.'
  209.           in a filename does not match a wildcard at the start of _p_a_t_t_e_r_n.
  210.  
  211.      --_c_o_l_o_r=_t_t_y, --_c_o_l_o_u_r=_t_t_y
  212.           Same as -_o but only if standard output is a terminal.  This is  very
  213.           useful  for  shell  scripts  and command aliases, especially if your
  214.           favorite pager does not support color control codes.
  215.  
  216.      --_c_o_l_o_r=_n_o, --_c_o_l_o_u_r=_n_o
  217.           Disables colorization.  This is the default.  Provided to override a
  218.           previous color option.
  219.  
  220.      --_h_e_l_p
  221.           Print a usage message on standard output and exit successfully.
  222.  
  223.      --_v_e_r_s_i_o_n
  224.           Print version information on standard output then exit successfully.
  225.  
  226.      --_u_n_i_x
  227.           Print plain UNIX long format instead of OS/2 format.
  228.  
  229.      DDDIIISSSPPPLLLAAAYYY CCCOOOLLLOOORRRIIIZZZAAATTTIIIOOONNN
  230.      When using the -_o or --_c_o_l_o_r options, this version of  lllsss  will  colorize
  231.      the  file  names  printed  according  to  the  name and type of file.  By
  232.      default, this colorization is by type only, and the codes  used  are  ISO
  233.      6429 (ANSI) compliant.
  234.  
  235.      You can override the default colors by defining the environment  variable
  236.      LLLSSS___CCCOOOLLLOOORRRSSS  (or LLLSSS___CCCOOOLLLOOOUUURRRSSS).  The format of this variable is reminicent of
  237.      the termcap(5) file format; a colon-separated list of expressions of  the
  238.      form  "xx=string",  where  "xx"  is  a  two-character variable name.  The
  239.      variables with their associated defaults are:
  240.  
  241.           nnnooo          0                 Normal (non-filename) text
  242.           fffiii          1                 Regular file
  243.           dddiii          32;1              Directory
  244.           eeexxx          35;1              Executable file
  245.           sssyyy          31;1              System file
  246.           rrrooo          33;1              Read-only file
  247.           hhhiii          44;37;1           Hidden file
  248.           lllccc          \e[               Left code
  249.           rrrccc          m                 Right code
  250.           eeeccc          (none)            End code (replaces lc+no+rc)
  251.  
  252.      You only need to include the  variables  you  want  to  change  from  the
  253.      default.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                              GNU File Utilities                              4
  260.  
  261.  
  262.  
  263. LS(1L)                     Unix Programmer's Manual                     LS(1L)
  264.  
  265.  
  266.      File names can also be colorized based on filename  extension.   This  is
  267.      specified  in the LS_COLORS variable using the syntax "*ext=string".  For
  268.      example, using ISO 6429 codes, to color all C-language source files  blue
  269.      you  would  specify "*.c=34".  This would color all files ending in .c in
  270.      blue (34) color.
  271.  
  272.      Control characters can be written either in C-style  \-escaped  notation,
  273.      or  in sssttttttyyy-like ^-notation.  The C-style notation adds \e for Escape, \_
  274.      for a normal space characer, and \?  for  Delete.   In  addition,  the  \
  275.      escape character can be used to override the default interpretation of \,
  276.      ^, : and =.
  277.  
  278.      Each file will be written as <lc> <color code> <rc> <filename> <ec>.   If
  279.      the  <ec>  code  is  undefined,  the sequence <lc> <no> <rc> will be used
  280.      instead.  This is generally more convenient to  use,  but  less  general.
  281.      The  left,  right  and  end  codes are provided so you don't have to type
  282.      common parts over and over again and to support weird terminals; you will
  283.      generally  not  need  to change them at all unless your terminal does not
  284.      use ISO 6429 color sequences but a different system.
  285.  
  286.      If your terminal does use ISO 6429 color codes, you can compose the  type
  287.      codes  (i.e. all except the lllccc, rrrccc, and eeeccc codes) from numerical commands
  288.      separated by semicolons.  The most common commands are:
  289.  
  290.            0          to restore default color
  291.            1          for brighter colors
  292.            4          for underlined text
  293.            5          for flashing text
  294.           30          for black foreground
  295.           31          for red foreground
  296.           32          for green foreground
  297.           33          for yellow (or brown) foreground
  298.           34          for blue foreground
  299.           35          for purple foreground
  300.           36          for cyan foreground
  301.           37          for white (or gray) foreground
  302.           40          for black background
  303.           41          for red background
  304.           42          for green background
  305.           43          for yellow (or brown) background
  306.           44          for blue background
  307.           45          for purple background
  308.           46          for cyan background
  309.           47          for white (or gray) background
  310.  
  311.      Not all commands will work on all systems or display devices.
  312.  
  313.      A few terminal programs do not recognize the default end  code  properly.
  314.      If all text gets colorized after you do a directory listing, try changing
  315.      the nnnooo and fffiii codes from 0 to the numerical codes for your standard fore-
  316.      and background colors.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                              GNU File Utilities                              5
  325.  
  326.  
  327.  
  328. LS(1L)                     Unix Programmer's Manual                     LS(1L)
  329.  
  330.  
  331. BBBUUUGGGSSS
  332.      On BSD systems, the -_s option reports sizes that  are  half  the  correct
  333.      values  for  files  that  are  NFS-mounted  from HP-UX systems.  On HP-UX
  334.      systems, it reports sizes that are twice the  correct  values  for  files
  335.      that  are  NFS-mounted from BSD systems.  This is due to a flaw in HP-UX;
  336.      it also affects the HP-UX lllsss program.
  337.  
  338.      Character set selection should be more system independent.
  339.  
  340.      Using the colorization options disables the use of the tab character  for
  341.      column  spacing  unless the -_T option is used; apparently some systems do
  342.      not like tabs and color codes in conjunction.
  343.  
  344.      If there was a single standard for the English language it would  not  be
  345.      necessary to support redundant spellings.
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.                              GNU File Utilities                              6
  390.  
  391.