cfetoolimport(8) [debian man page]

CFETOOLIMPORT(8)					User Contributed Perl Documentation					  CFETOOLIMPORT(8)

NAME

       cfetoolimport - import the contents of a database from XML format

SYNOPSIS

       cfetool import name --file|-f filename [--path|-p directory name] [--daily|-d] [--weekly|-w] [--yearly|-y] [--verbose|-v] [--help|-h]

DESCRIPTION

       Creates a new database from it's XML representation, in the format created by rrdtool dump.

       The -d, -w, and -y options specify which databases to create and look for in the dump, and may be combined. If they are all omitted, the
       default is to only import the weekly database.

OPTIONS

       --file|-f filename
	   Specifies the XML file to restore.

       --path|-p
	   The directory in which to create the new database folder. If this argument is not provided, the current working directory will be used.

       --daily|-d
	   Create a database for recording daily patterns.

       --weekly|-w
	   Create a database for recording weekly patterns.

       --yearly|-y
	   Create a database for recording yearly patterns.

       --verbose|-v
	   Print details of the command's execution to the standard output stream.

       --help|-h
	   Print a short help message and then exit.

EXAMPLE

	 % cfetool import temperature_copy --path /my/path --file ./temperature.xml

       Create a new weekly database, "temperature_copy", in the "/my/path" directory, and import it's contents from the file "temperature.xml" in
       the current working directory.

AUTHORS

       The code and documentation were contributed by Stanford Linear Accelerator Center, a department of Stanford University.	This documentation
       was written by

       Elizabeth Cassell <e_a_c@mailsnare.net> and
       Alf Wachsmann <alfw@slac.stanford.edu>

COPYRIGHT AND DISCLAIMER

	Copyright 2004 Alf Wachsmann <alfw@slac.stanford.edu> and
		       Elizabeth Cassell <e_a_c@mailsnare.net>
	All rights reserved.

perl v5.8.4							    2004-09-21							  CFETOOLIMPORT(8)

CFETOOLGRAPH(8) 					User Contributed Perl Documentation					   CFETOOLGRAPH(8)

NAME

       cfetoolgraph - create graphs from a cfetool database

SYNOPSIS

       cfetoolgraph name [--path|-p directory name] [--daily|-d] [--weekly|-w] [--yearly|-y] [--timestamps|-T] [--resolution|-r] [--help|-h]

DESCRIPTION

       The cfetoolgraph command dumps graphs of averages for visual inspection of the normal state database. The files are in a format viewable by
       "gnuplot" or "xgmr" or other graphical plotting program.

       The command generates three or four files in a subdirectory of the database directory with a name beginning with either "daily", "weekly"
       or "yearly", then "-", then either "snapshot" or the current time, if the -T option is used.  The files are named "average", "stddev", and
       "graph". The "graph" file contains both the averages and standard deviations, useful for plotting with error bars.

       If a histogram file is present, a fourth file named "distr" will also be created, plotting the distribution of fluctuations about the mean
       value.

       If the -d, -w and -y options are all omitted, the default is to only graph the weekly database.

OPTIONS

       --path|-p directory name
	   The directory in which the database specified by name can be found.

       --daily|-d
	   Graph the daily averages database.

       --weekly|-w
	   Graph the weekly averages database.

       --yearly|-y
	   Graph the yearly averages database.

       --timestamps|-T
	   Time-stamp the output filenames with the current time, in order to give a unique name.

       --resolution|-r
	   Generate high resolution data (), instead of averaging data over periods of one hour to generate simpler and smoother graphs.

       --help|-h
	   Prints a short help message and then exits.

EXAMPLE

	 % cfetoolgraph temperature --path /my/path --resolution

       Create graph files of the weekly database in high resolution in the "/my/path/temperature/weekly-snapshot" directory.

AUTHORS

       The code and documentation were contributed by Stanford Linear Accelerator Center, a department of Stanford University.	This documentation
       was written by

       Elizabeth Cassell <e_a_c@mailsnare.net> and
       Alf Wachsmann <alfw@slac.stanford.edu>

COPYRIGHT AND DISCLAIMER

	Copyright 2004 Alf Wachsmann <alfw@slac.stanford.edu> and
		       Elizabeth Cassell <e_a_c@mailsnare.net>
	All rights reserved.

perl v5.8.4							    2004-09-21							   CFETOOLGRAPH(8)