Command line options for the ./robodimm program


Some of these options are hazardous!  

For normal operation, please log onto robodimm pc as user "robodimm", to avoid executing some of these options by mistake.

RoboDIMM v0.99p, 18 Dec 2003

usage: robodimm [option ...] [other-arguments ...]

The following table gives a detailed description and explanation of the output of command
./robodimm --help

option (multi)


Long form synonym, single option*

Function

Notes

-m
--manual Do not start the robot automatically. Requires "startrobot" command. otherwise the robot will start automatically, minutes before sunset 
-E
--emulate Emulate the CCD camera and telescope hardware.  "Simulation mode", for software tests. 
-p
--park Park the telescope and exit the program
(robot is NOT started)
The Park position can be at zenith or the pole, as set in the configuration file.
-ln
--loglevel=n Start robot with a logging level (n=0..8), as follows:

logging level applies to the current session only


0 = 'Emergency', system is unusable


1 = 'Alert', serious error, action must be taken immediately


2 = 'Critical', critical conditions


3 = 'Error', standard error conditions


4 = 'Warning', user is normally informed about it but may be ignored


5 = 'Notice', normal but significant conditions


6 = 'Info', informational messages (a.k.a. verbose)


7 = 'Debug', normally not shown to the user, disabled in release mode currently used value in the configuration file


8 = 'Debug level 2', extra verbose debug output

-e
--email=EMAILADDR Start the robot but email the error reports to the given address  to send error reports to an address different from that in the configuration file (currently nom), e.g. yourself.
-d
--daemon run in the background (as a daemon) not yet used at ING
-t
--testtelescope Check whether the telescope is online and then exit Does not start robot. Useful check for telescope power.
-c
--testccd Check whether the CCD camera is online and then exit Does not start robot. Useful check for CCD power.
-r
--recalcseeing=DBNAME   Recalculate all seeing values for the centroids in the database DBNAME. Note: to recalculate data that was recorded in emulation mode, combine the -E option with this DANGER! 
Executable by "root".
can overwrite current DB!!!
-x
-x, --recalcext=DBNAME Recalculate all extinction AND seeing values for the centroids in the database DBNAME. Note: to recalculate data recorded in emulation mode, combine the -E option with this DANGER!
Executable by "root".
can overwrite current DB
-n
-n, --dbnowrite Test mode, do not write recalculated seeing values to the database.  Only works in combination with the option '-r'
-v
-v, --version Print version information and exit Prints version at start with all options in any case.
-s
--status Starts robot using current window as a Status Screen (ncurses) Alternative to a scrolling-message output. Can be unclear unless window correct size.
-S
--testseeing [files] Calculate a seeing value from the fits-files given on the command line. Also shows detailed information on the way it is calculated. The altitude is read from the files.
-D
--watchdogcheck Check whether the RoboDIMM software (this software) is still functioning properly. If that is not the case, the telescope will be parked and all robodimm instances will be killed.

*A double-dash (--') indicates that the rest of the line is not to be scanned for options.