du_report

Package: WA2L/edrc 1.5.57
Section: General Commands (1)
Updated: 05 October 2007
Index Return to Main Contents

 

NAME

du_report - create a disk usage summary report

 

SYNOPSIS

edrc/bin/du_report [ -h ]

du_report [ -c ][ -s ][ -l language ][ -f output_file ]

 

AVAILABILITY

WA2L/edrc

 

DESCRIPTION

Create a disk usage summary report based on the directories labeled with "disk usage index" files ( see: du_index(4) ) using the duvi(1) command.

du_report searches ..du_index files to create a report which lists the purpose of all labeled directories and some additional information as the size of the directory in kByte.

du_report only includes "disk usage index" files that have the correct file permissions of '700'.

 

OPTIONS

-h
usage message.

-l language
generate the report in the corresponding language. The language is resolved from the index file.

-c
use index cache file to create the report. The cache file contains all "disk usage index" files of previous runs. When you know, that no additional index files have been created since the last run of du_report in the root (/) directory, the report creation is speed up drastically due to the fact that not the whole system has to be searched for index files. All index files in the cache are verified against the current situation ahead of do the reporting. If an index file has been created in a certain sub directory (e.g. /export/dat/development/docs) and du_report has been called while staying in this directory, it is added to the index cache file, too.

-s
do not summarize the disk usage for the directories.

-f output_file
file where to save the report to. If this option is not specified, the report is printed to stdout.

 

ENVIRONMENT

-

 

EXIT STATUS

0
no error.

1
du_report has been started as another user then 'root'.

1
the directory where to place the output_file does not exist.

4
usage printed.

5
report creation aborted.

11
temporary directory could not be claimed or created in /tmp. Check the system temporary directory /tmp if you get this error, it is an indicator of system intrusion.

 

FILES

..du_index
"disk usage" index file.

/var/tmp/du_report.indexfilecache
cache of all "disk usage index" files found during previous runs. If du_report is called using the -c option, this file is read.

 

EXAMPLES

-

 

SEE ALSO

duvi(1), du_index(4), edrcintro(1), vi(1)

 

NOTES

-

 

BUGS

-

 

AUTHOR

du_report was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net .

 

COPYRIGHT

Copyright © 2008 Christian Walther

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:52:46 GMT, August 28, 2024