1AMTOC(8)                                                              AMTOC(8)
2
3
4

NAME

6       amtoc - generate TOC (Table Of Contents) for an Amanda run
7

SYNOPSIS

9       amtoc [-a] [-i] [-t] [-f file] [-s subs] [-w] [--] logfile
10

DESCRIPTION

12       Amtoc generates a table of contents for an Amanda run. It's a perl
13       script (if you don't have perl, install it first!).
14

OPTIONS

16       -a
17           The output file name will be label-of-the-tape.toc in the same
18           directory as logfile.
19
20       -i
21           Display help about amtoc.
22
23       -t
24           Generate the output in tabular form.
25
26       -f file
27           Write the output to a file ('-' for stdout).
28
29       -s subs
30           Evaluate the output file name from subs, with $_ set to
31           label-of-the-tape. The -a option is equivalent to -s 's/$_/.toc/'.
32
33       -w
34           Separate tapes with form-feeds and display blank lines before
35           totals.
36
37       --
38           Marks the last option so the next parameter is the logfile.
39
40       logfile
41           (use '-' for stdin)
42

OUTPUT FORMAT

44       The standard output has five fields separated by two spaces:
45
46           #  Server:/partition  date  level  size[Kb]
47           0  daily-05:  19991005  -  -
48           1  cuisun15:/cuisun15/home  19991005  1  96
49           2  cuinfs:/export/dentiste  19991005  1  96
50             ...
51           103  cuisg11:/  19991005  0  4139136
52           103  total:  -  -  16716288
53
54
55
56       In tabular format (-t), this would look like:
57
58             #  Server:/partition           date      lev  size[Kb]
59             0  daily-05:                   19991005    -         -
60             1  cuisun15:/cuisun15/home     19991005    1        96
61             2  cuinfs:/export/dentiste     19991005    1        96
62             ...
63           103  cuisg11:/                   19991005    0   4139136
64           103  total:                      -           -  16716288
65
66

USAGE

68       The easiest way to use it is to run amtoc right after amdump in the
69       cron job:
70
71           amdump daily ; logdir=`amgetconf daily logdir` ; log=`ls -1t $logdir/log.*.[0-9] | head -1` ; amtoc -a $log
72
73
74       which will generate /usr/local/etc/amanda//daily/tape_label.toc. You
75       may also want to call amtoc after an amflush.
76

SEE ALSO

78       amanda(8), amdump(8), amflush(8), amgetconf(8), cron, perl
79

AUTHOR

81       Nicolas Mayencourt <Nicolas.Mayencourt@cui.unige.ch>, University of
82       Geneva/Switzerland : Original text
83
84       Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the
85       Amanda-documentation: XML-conversion
86
87
88
89                                  02/07/2007                          AMTOC(8)