next up previous contents index
Next: Xic Environment Variables Up: Starting Xic Previous: Graphics Support and Requirements   Contents   Index

Command Line Options

The following syntax applies when Xic is invoked from the command line. Arguments not recognized as options are expected to be files containing layout information in supported formats. The first such file (if any) will be loaded into the editor. Subsequent files can be loaded sequentially with the Edit command.



xic [-T[extension]] [-E] [-Ggeometry_spec] [-Hdirectory_path] [-Kpassword] [-Lserverhost]
[-S[port] | -Bbatch_opt] [-C | -C1] [toolkit_options] [filename ...]

Xic will accept command line options common to applications designed around the GTK+ user interface toolkit. In addition, there are a few command line options used exclusively by Xic. Options are keyed by a hyphen `-', and can not be grouped. Above, the square brackets indicate that the specification is optional (which applies to all arguments), and the `|' symbol is a logical ``OR'' operator indicating that one may specify one of the surrounding forms.

-T[extension]
The -Textension option is used to designate a particular technology file, which is a file used by Xic to initialize itself to a particular manufacturing process and set of user preferences. The technology file has a name of the form xic_tech or xic_tech.extension, the base name is always ``xic_tech'', but there may be an arbitrary extension (characters other than `.' following `.'). If no -T option is given, then the xic_tech file is used. Otherwise, the extension given in the option will signal Xic to use the technology file with the same extension. Note that it is allowable to start Xic without any technology file, which is the effect of giving just the -T without any extension. Note that there must not be any space between the T and the extension.

-E
The -E option signals Xic to start in electrical mode. The default is to start in physical mode.

-Ggeometry_spec
The geometry_spec is an X-style window geometry specification, which allows the main window size and position to be specified. There is no space between -G and the specification. The command line specification will override the XIC_GEOMETRY variable. The format of the geometry_spec is described with the environment variable.

-Hdirectory_path
Giving this option will cause Xic to start in directory_path as the current working directory. Note that there is no space between the ``-H'' and the directory path.

-Kpassword
The password used to enable use of encrypted scripts can be given to Xic on the command line with this option. Note that there is no space between the ``-K'' and the password. As the password can contain almost any character, if the password contains characters which could be misinterpreted by the shell, the password should be quoted, e.g., -K'password'.

If no password is given to Xic with the -K option, a default password is effective. The default password has a key that is compiled into the executable file, which can be changed with the wrsetpass utility. The ``factory'' default password is

Default password: qwerty
The password set with the -K option overrides the default password. The password can also be set with the SetKey script function.

If the .xicinit or .xicstart file, or the function library file, or a script run from batch mode is encrypted, the encryption password must be given to Xic with the -K option, or be the default password. As the password can be changed with the SetKey script function, User Menu scripts can in principle use different passwords, which must be set before the script is executed.

-Lserverhost
This supplies the host name of the machine running the license server. Note that there is no space after -L. If given, this will override the server host supplied by other means.

Below is the logic hierarchy for setting the license server host, each method will override those listed lower. See the documentation for the xtlserv (license server) program for more information.

-Lserverhost
XTLSERVER in environment
license.host file
xtlserver in /etc/hosts
name of local machine

-S[port]
If the -S option is given, Xic will run in server mode. In this mode, Xic runs in the background as a daemon process, serving requests through a communications port. This mode will be described in 2.5. The option can be immediately followed (no space) by a port number to use for connections.

-Bbatch_opt
Xic supports a batch mode of operation, where Xic will run a script or perform certain commands without graphics. The form for this option is one of
-Bscriptfile[,args...]
-B-command
Batch mode will be described in 2.4.

The -C and -C1 options apply only to ``pseudo-color'' displays. These are displays with ``8-bits'' or ``256 colors'', found frequently on Sun workstations.

By default, Xic uses a large percentage of the system colormap. If there are insufficient colormap entries available, Xic will create its own virtual colormap, which is loaded when an Xic window has the keyboard focus. A problem is that some X terminals and emulators apparently do not support virtual colormaps, or do so improperly. Also, the use of a virtual colormap can be annoying. For these reasons, options have been provided to limit colormap usage, and avoid creation of a virtual colormap.

-C
The -C option, if given, will prevent Xic from allocating private colors from the system colormap. Instead, it will use cells shared with other applications. The colormap usage can be dramatically reduced by this option. The cost is 1) the colors may not be quite ``right'' if the colormap is already heavily used by other applications, 2) there is no blinking, 3) the colors can not be changed, and 4) highlighting may be difficult to see, as for the -C1 option. A second copy of Xic running with the same technology file as the first will use no additional colormap space. A virtual colormap is never produced if the -C option is given. This option is recommended primarily for users who want to run multiple copies of Xic without the virtual colormap.

-C1
The -C1 option similarly saves colormap space by directing Xic to allocate single plane cells. By default, and if sufficient colormap space is available, Xic will allocate ``dual plane'' color cells for the layer rendering colors. These cells contain two pixel values, one representing the color, and one which is white. The white pixel is addressed during highlighting, and having one white pixel per layer ensures that the exclusive-or drawing mode always produces white highlighting.

If colormap space is short, Xic will allocate single plane cells. Xic will also use single plane cells if the -C1 option is given on the command line. This of course uses half the colormap space of dual plane cells. However, the exclusive-or highlighting is only guaranteed to be white over the background, and the highlighting can take any color over the layers. This can sometimes be difficult to see.

The graphical interface accepts the following options. These options are not processed by Xic, but are intercepted by the graphics subsystem and affect the interface to the X-window system. The multiple forms are equivalent.

$\textstyle \parbox{4in}{
{\sf -d} {\it dispname}\\
{\sf -display} {\it dispname}\\
{\sf \symbol{45}\symbol{45}display} {\it dispname}}$
This option specifies the name of the X display to use. The dispname is in the form
[host]:server[.screen]
The host is the host name of the physical display, server specifies the display server number, and screen specifies the screen number. Either or both of the host and screen elements to the display specification can be omitted. If host is omitted, the local display is assumed. If screen is omitted, screen 0 is assumed (and the period is unnecessary). The colon and (display) server are necessary in all cases. If no display is specified on the command line, the display is set to the value of the environment variable DISPLAY.

$\textstyle \parbox{4in}{
{\sf -name} {\it string}\\
{\sf \symbol{45}\symbol{45}name} {\it string}}$
This option provides and alternative name to the application, as known to the X window system. The application name is used by X to apply resource specifications.

--class string
This option provides and alternative class name to the application, as known to the X window system. The application class name is used by X to apply resource specifications.

$\textstyle \parbox{4in}{
{\sf -synchronous}\\
{\sf \symbol{45}\symbol{45}sync}}$
This option indicates that requests to the X server should be sent synchronously, instead of asynchronously. Since the X system normally buffers requests to the server, errors do not necessarily get reported immediately after they occur. This option turns off the buffering so that the application can be debugged more easily. It should never be used with a working program.

--no-xshm string
If this option is given, shared memory will not be used between the application and an X server on the same machine, if shared memory is available. There is no reason to use this option except for program debugging purposes.

Any words found in the command line that are not recognized as options will be interpreted as files to load into Xic for editing. The files will be loaded in order of their appearance, with the first file loaded at startup, and the other files loaded in response to an Edit command.


next up previous contents index
Next: Xic Environment Variables Up: Starting Xic Previous: Graphics Support and Requirements   Contents   Index
Stephen R. Whiteley 2006-10-23