CountShortIds(1)

Name

CountShortIds - count the number and sizes of files in ShortId lists

Synopsis

CountShortIds [ -w ] filename ...

Description

To do source and derived weeding, the repository reads files that contain lists of ShortIds. (The list of derived ShortId's written by the weeder may actually contain sources; see ShortIdSetDiff(1) for how to subtract the sources out of the derived keep list.) A ShortId list is a file that contains the ShortId's of source or derived files for the repository to keep. The ShortId's in such files are listed in hexadecimal, with exactly one ShortId per line. ShortId lists may contain duplicates.

For each filename argument, CountShortIds opens the corresponding file in the repository, and interprets its contents as a list of ShortId's. For each such list, it prints:

• the total number of ShortId's specified,
• the total number of unique ShortId's whose size could be determined,
• the total number of unique ShortId's whose corresponding files were skipped due to errors,
• the total sizes of the processed unique files, and
• the mean size of the processed unique files.

Any filename starting with "0x" is assumed to be a hexadecimal value denoting the ShortId of a file in the repository. Rather than reading the file named by the literal filename argument, CountShortIds instead reads the file in the repository denoted by the hexadecimal value.

By default, if the size of the file corresponding to a specified ShortId cannot be determined, it is skipped silently. If -w is specified, a warning message is printed for each such file.

See Also

ShortIdSetDiff(1), VCacheStats(1), VestaWeed(1)

Author

Allan Heydon (heydon@src.dec.com)

Created on Wed Aug 20 22:47:34 PDT 1997 by heydon
Last modified on Fri Nov  9 14:31:15 EST 2001 by ken@xorian.net
     modified on Fri Aug 22 00:02:42 PDT 1997 by heydon