Merge branch 'refs/heads/t/doc-improvements'
[adu.git] / adu.1.inc
1 [NAME]
2 adu \- advanced disk usage
3 [EXAMPLES]
4
5 .PP
6 The following example creates a database containing the disk usage
7 patterns of the /var directory:
8 .IP
9 $ adu --create --database-dir /root/adu-var --base-dir /var
10 .PP
11 Here's a simple query that uses the newly created database to print
12 the user-summary:
13 .IP
14 $ adu --select --database-dir /root/adu-var
15 .PP
16 To print the one-line global summary instead, use
17 .IP
18 $ adu --select --database-dir /root/adu-var --select-options '--select-mode global_summary'
19 .PP
20 To sort the user summary by file count rather than by file size, run
21 .IP
22 $ adu --select --database-dir /root/adu-var --select-options '--list-sort=file_count'
23 .PP
24 The command below prints the five largest directories of the users root and
25 mysql:
26 .IP
27 $ adu --select --database-dir /root/adu-var --select-options '--select-mode user_list --user root --user mysql --limit 5'
28 .PP
29 The same, using short options:
30 .IP
31 $ adu -Sd /root/adu-var -s '-m user_list -u root -u mysql -l 5'
32 .PP
33 Again the same, but omitting /var/cache:
34 .IP
35 $ adu -Sd /root/adu-var -s '-m user_list -u root -u mysql -l 5 -p !^cache/'
36 .PP
37 A simple script for interactive mode:
38
39 .EX
40 set -m user_list
41 set -u root
42 set -o file-list.root
43 run
44 reset
45 set -m user_list
46 set -u mysql
47 set -o file-list.mysql
48 run
49 .EE
50 .PP
51 Run adu in interactive mode with the above script (adu-script.txt):
52 .IP
53 $ adu -Id /root/adu-var < adu-script.txt
54
55 [SEE ALSO]
56 .BR du (1)