Next: The tbsetup Command
Up: The WRspice User Interface
Previous: Sparse Matrix Package
Contents
Index
Initialization Files
WRspice will attempt to source startup files used for
initialization when the program is started. First, a file named
``wrspiceinit'' is searched for in the system startup directory,
and if found is sourced into WRspice. The system startup directory
has a default location built into the program
(/usr/local/share/xictools/wrspice/startup, or if XT_PREFIX
is set in the environment, its value replaces ``/usr/local''),
but this can be changed by setting the SPICE_LIB_DIR
environment variable to another location.
-
- license.host file
When using a license server on a remote machine, it is necessary to
provide the name of this machine or WRspice can not run. One way
to do this is to create a license.host file in the startup
directory, e.g. /usr/local/share/xictools/wrspice/startup. The
license.host file consists of a single line of text, giving the
host name of the license server machine. The host name can optionally
be suffixed with ``:port'', where port is the port
number in use by the license server. This is required if for some
reason the license server is not running on the default port.
- .wrspiceinit file
Files named ``.wrspiceinit'' are searched for in the user's home
directory, and the current directory, and are sourced, if found, in
that order. If running on Microsoft Windows which does not support
the notion of a home directory, WRspice will look in the
environment for a variable named ``HOME'', and its value will be
taken as the path to the "home directory". If not set, the search is
skipped.
These files have identical format, and contain ordinary script
commands, which can be used to set the default behavior of WRspice.
The first line is ignored, but all remaining lines are taken as script
commands. The special directive tbsetup, which can only appear
in these files, provides the setup information for the graphical
interface. Unlike ordinary input files, it is not necessary to
enclose the commands in .control or .exec blocks in the
startup files.
- X Resources
When using the X-window system, the X resource-passing mechanism can
be used to set the default colors used in plots. The resource
mechanism is otherwise ignored in the current version of WRspice.
The base names for the color resources are ``color0'' through
``color19'', with the corresponding class names capitalized.
Thus, one way to define alternative plotting colors is to create a
file named ``Wrspice'' in the user's home directory, which
contains lines like
*color2: red
for each new color definition. The color name should be known to the
X window system, i.e., be listed in the rgb.txt file in the
X-windows system library.
The same definitions could be placed in a .wrspiceinit file with
lines like ``set color2 = red''.
- .wrpasswd file
On startup, WRspice will read the .wrpasswd file if found in
the user's home directory. This file contains the encrypted password
to the program distribution repository, and is created in WRspice
with the passwd command. This file can also be generated from
Xic. If present and the password is active, WRspice will check
for the availability of updates on startup, and the wrupdate
command will be enabled.
Subsections
Next: The tbsetup Command
Up: The WRspice User Interface
Previous: Sparse Matrix Package
Contents
Index
Stephen R. Whiteley
2012-09-24