Reword summary text.
[adu.git] / README
1 adu creates a database containing disk usage statistics of a given
2 directory. This database can be queried to quickly retrieve, for
3 example, the number and the size of all files in a subdirectory owned
4 by a given user.
5
6 Four different output modes are available: global list, global summary,
7 user list and user summary. The format of the output may be customized
8 via format strings.
9
10 There's an interactive mode which allows to quickly launch many queries
11 on the same database using different modes and different output files.
12
13 By default, adu uses the user-summary output format which looks like
14 this:
15
16         User summary
17         root                0   605    12K  267m
18         mysql             103     8   144    81m
19         postgres          113    19   506    31m
20         man                 6    37    87     2m
21         syslog            101     1    54     1m
22         ...
23
24 The user-list mode prints the largest directories of one or more users:
25
26         uid 0 (root):
27           55m    8  /var/cache/apt/apt-file/
28           43m   35  /var/lib/apt/lists/
29           27m    6K /var/lib/dpkg/info/
30           25m    4  /var/cache/apt/
31           20m  118  /var/lib/gconf/defaults/