Purpose

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 state2

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