gschem man page

gschem — gEDA/gaf Schematic Capture


gschem [OPTION ...] [--] [FILE ...]


gschem is a schematic capture application, and is part of the gEDA (GPL Electronic Design Automation) toolset.  It is used to draw electronic schematics, which describe the logical structure of an circuit.  Schematics are made up of symbols, which represent the various components in the circuit, and are obtained either from a standard library or created by the user.  The connections between components represented by nets (wires).  Schematics may be printed to a PostScript file for printing or further conversion to other output formats.  Output to various image formats is also supported.

gschem can also be used for editing symbols for use in schematics.


-q, --quiet

Quiet mode. Turn off all warnings/notes/messages.

-v, --verbose

Verbose mode.  Output all diagnostic information.

-r, --config-file=FILE

Specify an additional configuration file.  Normally gschem searches for the system configuration file, then `$HOME/.gEDA/gschemrc', and finally for a `gschemrc' file in the current working directory.  This option allows the user to specify an additional rc file which is read after all the other rc files have been are read.


Prepend DIRECTORY to the list of directories to be searched for Scheme files.


Specify a Scheme script to be executed at startup.


Specify a Scheme expression to be evaluated at startup.

-o, --output=FILE

Specify a filename for PostScript output.  This command line argument is useful when running gschem from a shell script and with a Scheme script.  The filename can be changed through the print dialog box.


Automatically place the window. This may be useful if running gschem from the command line and generating output.

-h, --help

Print a help message.

-V, --version

Print gschem version information.


Treat all remaining arguments as schematic or symbol filenames.  Use this if you have a schematic or symbol filename which begins with `-'.

Schematic and Symbol Files

Optionally, schematic or symbol FILEs may be specified on the command line.  Any schematic or symbols specified are loaded at startup as separate documents in the schematic editor.

If no FILEs are specified, a blank schematic is created for editing.



specifies the search directory for Scheme and rc files.  The default is `${prefix}/share/gEDA'.


specifies the search directory for rc files.  The default is `$GEDADATA'.


See the `AUTHORS' file included with this program.

See Also

gnetlist(1), gsymcheck(1)

The full documentation for gschem is available from within the program by selecting the `gEDA Documentation' option from the program's `Help' menu.

Referenced By

convert_sym(1), garchive(1), gattrib(1), gmk_sym(1), gnetlist(1), grenum(1), gsch2pcb(1), gschlas(1), gsymcheck(1), gsymfix(1), olib(1), pads_backannotate(1), pcb_backannotate(1), sarlacc_schem(1), sarlacc_sym(1), schdiff(1), tragesym(1).

September 25th, 2013 gEDA Project