home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dirutl / twoutils.arc / LS.DOC < prev    next >
Encoding:
Text File  |  1989-10-14  |  4.2 KB  |  110 lines
  1.                          LS - Formatted Directory Utility
  2.                         ----------------------------------
  3.  
  4. Syntax:     LS [FILESPEC]
  5.  
  6. Options:    /ATTRIBUTES             default
  7.             /CLUSTERS
  8.             /DATE
  9.             /DIRECTORIES            default
  10.             /EXCLUDE=<FILESPEC>
  11.             /EXTENSION
  12.             /HEADER                 default
  13.             /HIDDEN
  14.             /OUTPUT=<FILENAME>
  15.             /PRINT
  16.             /REVERSE
  17.             /SIZE
  18.             /SYSTEM
  19.             /TRAILER                default
  20.             /VERSION
  21.             /WIDE
  22.  
  23. Remarks:    LS displays a formatted directory listing very similar to that
  24.             available with the DOS 'DIR' command.  LS provides more
  25.             flexibility than the DIR command, and has several useful
  26.             additional features.  See the 'Options' section below for a
  27.             summary of the features available.
  28.  
  29. Wild Cards: The wild card specification used with LS is different to that
  30.             used by DOS.  DOS does not match wild card specifications
  31.             correctly.  LS will match any wild card specification exactly.
  32.             The following are examples:
  33.  
  34.                *s*           Matches any filename including an 'S' character.
  35.                ?*s*.tmp      Matches any file with type 'TMP' whose filename
  36.                              contains an 'S' after the first character.
  37.                *tmp*.*       Matches any file with 'TMP' in the name.
  38.                *.*           Matches any file with a name and extension.
  39.                *             Matches all filenames regardless of extension.
  40.  
  41.             Note the difference of '*' and '*.*'.  This implies that the
  42.             '.' character is treated exactly as any other character.
  43.  
  44.             DOS would fails with all of the first three examples, by matching
  45.             ALL filenames with the specifications given!
  46.  
  47. Options:    /ATTRIBUTES (default)
  48.             Displays the file attributes with the directory entry for each
  49.             file.  The attribute codes are (A)rchive, (H)idden, (R)ead-only
  50.             and (S)ystem.
  51.  
  52.             /CLUSTERS
  53.             Displays the number of disc clusters associated with the file.
  54.             A cluster is the minimum allocation unit on the disc and is made
  55.             up on an integral number of sectors, usually 4 for a fixed disc.
  56.  
  57.             /DATE
  58.             Sorts the directory listing on ascending file date and time
  59.             instead of the default name.
  60.  
  61.             /DIRECTORIES (default)
  62.             Includes directories in the listing.  This is a default.  If the
  63.             option is explicitly specified, the directories '.' and '..' will
  64.             be included in the list.  If /NODIRECTORIES is specified, no
  65.             directories will be shown.
  66.  
  67.             /EXCLUDE=<FILESPEC>
  68.             Excludes files matching the specified filespec from the directory
  69.             list.
  70.  
  71.             /EXTENSION
  72.             Sorts the directory listing on file extension and then name
  73.             instead of the other way round.
  74.  
  75.             /HEADER (default)
  76.             Includes the directory header in the listing.  The header simply
  77.             contains the name of the directory.
  78.  
  79.             /HIDDEN
  80.             Allows DOS hidden files to be included in the listing.
  81.  
  82.             /OUTPUT=<FILENAME>
  83.             Forces the directory listing output to go to the named file
  84.             rather than the screen.
  85.  
  86.             /PRINT
  87.             Forces the directory listing output to go to device PRN: rather
  88.             than the screen.
  89.  
  90.             /REVERSE
  91.             Reverses the directory listing sort order, i.e. all sorting will
  92.             be descending rather than ascending.
  93.  
  94.             /SIZE
  95.             Sorts the directory listing by file size.
  96.  
  97.             /SYSTEM
  98.             Allows DOS system files to be included in the listing.
  99.  
  100.             /TRAILER
  101.             Displays the directory listing trailer which includes a file
  102.             count, size total and shows the free bytes remaining on the
  103.             device.
  104.  
  105.             /VERSION
  106.             Shows the LS version number.
  107.  
  108.             /WIDE
  109.             Generates a wide listing suitable for output to a list device.
  110.