Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

10.0;lst (list_storge_tree), revision 1.0, 88/01/21
lst source [-ae] [-l | [-ld|-lf|-ll]...]
                [-af date] [-be date] [-dim]
                [-lev n] [-st] [-nsd] {cl}



DESCRIPTION
     lst prints the number of kilobytes contained in all files and directories
     specified by names. Links within a tree are not followed.  If you do not
     specify a names argument, lst prints information about the current
     directory by default. Temporary file space is not included in this count.


OPTIONS
     -ae            Abort on an error. The default is to continue the list.

     -af date       List files with a date/time modified greater than
                    specified date/time.

     -be date       List files with a date/time modified less than specified
                    date/time.

     -l             List all directories, files, and links.

     -ld (default)  List directories.

     -lf            List files.

     -ll            List links.

     -dtm           List the date/time modified of objects selected.

     -lev n         List only objects n levels or fewer below source
                    directory.

     -st            List statistics.

     -nsd           Ignore system directories (that is, mounted file systems).

     lst traverses the specified tree and counts storage occupied by files
     satisfying the optional date criteria, accumulating totals for every
     directory.  Links within the tree are not followed.

     -ld, -lf, -ll may be negated as -nld, -nlf, -nll.

     Wildcards or link may be specified for the source pathname.  This command
     uses the common command-line handler; type help cl for more information.

     Statistics reports the following information per nest  level  for  each
     tree:

          - no. of files, storage utilization for the files
          (in kilobytes),
          storage/file
          - no. of trees, storage utilization for the trees
          (in kilobytes),
          storage/tree
          - no. of links

     If more than one tree is specified with the -st option the following is
     generated:

          - individual statistics report for each tree
          - average statistics report over all specified trees

     Note that trees = 0 with some value for storage reflects the overhead for
     that directory's files.

EXAMPLES
     $ lst backup/performance backup/backup.info -lev 1 -st

     (dir)    1002  backup/performance

     Tree Statistics for backup/performance
                              storage                   storage
     nest     files  storage   / file   trees  storage   / tree   links
        0        34      998     29.4       0        4      0.0       2
               -----  -------            -----  -------            -----
                 34      998     29.4       0        4      0.0       2

     (dir)      13  backup/backup.info/debug_info
     (dir)      45  backup/backup.info/bug_info
     (dir)      19  backup/backup.info/info
     (dir)     279  backup/backup.info

     Tree Statistics for backup/backup.info
                              storage                   storage
     nest     files  storage   / file   trees  storage   / tree   links
        0        28      199      7.1       3       80     26.7       0
        1        19       73      3.8       0        4      0.0       3
              -----  -------            -----  -------            -----
                 47      272      5.8       3       84     28.0       3

     Averages for 2 trees
           files  files storage storage storage
     nest    ave  stdev     ave   stdev  / file
        0   31.0    3.0   598.5   399.5    19.3
        1    9.5    9.5    36.5    36.5     3.8
           ------ ------ ------- -------
            20.3    6.3   317.5   218.0    15.7

     trees  trees storage storage storage   links  links
       ave  stdev     ave   stdev  / tree     ave  stdev
       1.5    1.5    42.0    38.0    28.0     1.0    1.0
       0.0    0.0     2.0     2.0     0.0     1.5    1.5
     ------ ------ ------- -------          ------ ------
       0.8    0.8    22.0    20.0    29.3     1.3    1.3



SEE ALSO
     More information is available.  Type

     help  datetime For information on date-time syntax

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026