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