DEIMOS user script restore

Name

restore_state -- restore previously saved INSTRUMENT configuration

Purpose

Return the instrument to the state it was in when the
"save_state" command was last executed.

Usage

restore_state [-clobber] [-verify] [-debug] [-noxeq]
[save_file [script_file]]

Flags

-(c)lobber clobber existing script file
-(v)erify validate keywords upon completion
-(d)ebug print troubleshooting output
-(n)oxeq do not execute the script to restore parameters,
only build it and exit

Arguments

save_file = name of the save file to read. The default is
to read the file ~/.save_state.YYYY-MMM-DD. If the
default file is read, it is also deleted.
script_file = name of the shell script to generate. The default is
~/.restore_state.$$

Output

None, unless -debug option is set

Restrictions

- Unless the clobber flag is set, this script will not
overwrite an existing script file

Exit values

0 = normal completion
1 = error parsing input save file
2 = fatal error
4 = error running script file
8 = error validating keyword

Example

1) save all settings to the default save file, and restore them:
save_state
...additional commands...
restore_state

2) save all settings, including INFOMAN-only keywords,
then restore and verify settings:
save_state -i
...additional commands...
restore_state -v

3) save state to a named file, then restore from that file:
save_state state1
...additional commands...
restore_state state1

4) generate, but do not execute, a script named "myscript" to
restore all settings, taking readings from the default file:
save_state
restore_state -n default myscript

5) provide debugging output while restoring:
save_state
restore_state -d