Chapter 17. Using the Gold Shell (goldsh)

goldsh is an interactive control program that can access all of the advanced functionality in Gold.

Caution

The goldsh control program allows you to make powerful and sweeping modifications to many objects with a single command. Inadvertant mistakes could result in modifications that are very difficult to reverse.

17.1. Usage

Gold commands can be invoked directly from the command line as arguments, or read from stdin (interactively or redirected from a file).

goldsh [—debug] [-? | —help] [--man] [—raw] [—quiet] [-v | —verbose] [<Command>]

Example 17-1. Specifying the command as direct arguments

$ goldsh System Query

Name Version  Organization Description  
------ ------------ ------------------ ------------------ 
Gold 2.0.b1.0              Beta Release 
        

Example 17-2. Using the interactive prompt

$ goldsh

gold> System Query

Name Version  Organization Description  
------ ------------ ------------------ ------------------ 
Gold 2.0.b1.0              Beta Release 
        

gold> quit

Example 17-3. Reading commands from a file

$ cat >commands.gold <<EOF

System Query
quit
EOF
          

$ goldsh <commands.gold

Name Version  Organization Description  
------ ------------ ------------------ ------------------ 
Gold 2.0.b1.0              Beta Release