1CFETOOLCREATE(1)      User Contributed Perl Documentation     CFETOOLCREATE(1)
2
3
4

NAME

6       cfetool create - Set up a new Database
7

SYNOPSIS

9       cfetool create name [--path⎪-p directory name] [--step⎪-s step]
10       [--daily⎪-d] [--weekly⎪-w] [--yearly⎪-y] [--cfenvd⎪-c] [--his‐
11       tograms⎪-H] [--verbose⎪-v] [--file⎪-f filename] [--help⎪-h]
12

DESCRIPTION

14       Creates a new database and, optionally, histogram file in a new direc‐
15       tory with the name given. If the -p option is specified, it will be
16       created as a subdirectory of the path given. Otherwise, it will be a
17       subdirectory of the current working directory.
18
19       The -d, -w, and -y options specify the period over which the data will
20       span, and may be combined to create multiple databases. If they are all
21       ommitted, the default is weekly.
22

OPTIONS

24       --path⎪-p
25           The directory in which to create the new database folder. If this
26           argument is not provided, the current working directory will be
27           used.
28
29       --step⎪-s
30           The interval, in minutes, with which the database will be updated.
31           If this argument is not provided, cfetool assumes a default of 5
32           minutes.
33
34       --daily⎪-d
35           Create a database for recording daily patterns.
36
37       --weekly⎪-w
38           Create a database for recording weekly patterns.
39
40       --yearly⎪-y
41           Create a database for recording yearly patterns.
42
43       --cfenvd⎪-c
44           Communicate with cfengine. If this option is specified, cfetool
45           will set classes understandable by cfagent. For more information,
46           see the cfenvd documentation.
47
48       --histograms⎪-H
49           Create a histogram file, to store information about the probability
50           distribiution of fluctuations about the mean value over all times
51           of day.  Cfetool won't write anything to this file for the first
52           four weeks, as it has to have reliable mean values in order to
53           accurately calculate it.
54
55       --verbose⎪-v
56           Print details of the command's execution to the standard output
57           stream.
58
59       --file⎪-f
60           Specifies a file which contains measurements to feed into the data‐
61           base in batch mode. Used for testing purposes. Each line in the
62           file should be in either of these formats:
63
64           month/day/year hour:min:sec value
65
66           or
67
68           epoch value
69
70       --help⎪-h
71           Prints a short help message and then exits.
72

EXAMPLE

74         % cfetool create temperature --path /my/path --histograms --step 10
75
76       Creates an empty database and histogram file in /my/path/temperature/,
77       ready to store values over ten minute intervals spanning a one-week
78       period.
79

AUTHORS

81       The code and documentation were contributed by Stanford Linear Acceler‐
82       ator Center, a department of Stanford University.  This documentation
83       was written by
84
85       Elizabeth Cassell <e_a_c@mailsnare.net> and
86       Alf Wachsmann <alfw@slac.stanford.edu>
87

89        Copyright 2004 Alf Wachsmann <alfw@slac.stanford.edu> and
90                       Elizabeth Cassell <e_a_c@mailsnare.net>
91        All rights reserved.
92
93
94
95perl v5.8.4                       2004-09-22                  CFETOOLCREATE(1)
Impressum