LAYERS(1) INTERACTIVE UNIX System LAYERS(1)
NAME
layers - layer multiplexer for windowing terminals
SYNOPSIS
layers [-s] [-t] [-d] [-p] [-f file] [layersys-prgm]
DESCRIPTION
The layers command manages asynchronous windows [see
layers(5)] on a windowing terminal. Upon invocation, layers
finds an unused xt(7) channel group and associates it with
the terminal line on its standard output. It then waits for
commands from the terminal.
Command-line options:
-s Reports protocol statistics on standard error at the
end of the session after you exit from layers. The
statistics may be printed during a session by invok-
ing the program xts(1M).
-t Turns on xt(7) driver packet tracing, and produces a
trace dump on standard error at the end of the ses-
sion after you exit from layers. The trace dump may
be printed during a session by invoking the program
xtt(1M).
-d If a firmware patch has been downloaded, prints out
the sizes of the text, data, and bss portions of the
firmware patch on standard error.
-p If a firmware patch has been downloaded, prints the
downloading protocol statistics and a trace on stan-
dard error.
-f file Starts layers with an initial configuration speci-
fied by file. Each line of the file represents a
layer to be created, and has the following format:
origin_x origin_y corner_x corner_y command_list
The coordinates specify the size and position of the
layer on the screen in the terminal's coordinate
system. If all four are 0, the user must define the
layer interactively. command_list, a list of one or
more commands, must be provided. It is executed in
the newlayer using the user's shell (by executing:
$SHELL -i -c "command_list"). This means that the
last command should invoke a shell, such as /bin/sh.
(If the last command is not a shell, then, when the
last command has completed, the layer will not be
functional.)
layersys-prgm
Rev. Base System Page 1
LAYERS(1) INTERACTIVE UNIX System LAYERS(1)
A file containing a firmware patch that the layers
command downloads to the terminal before layers are
created and command_list is executed.
Each layer is in most ways functionally identical to a
separate terminal. Characters typed on the keyboard are
sent to the standard input of the UNIX system process
attached to the current layer (called the host process), and
characters written on the standard output by the host pro-
cess appear in that layer. When a layer is created, a
separate shell is established and bound to the layer. If
the environment variable SHELL is set, the user will get
that shell: otherwise, /bin/sh will be used. In order to
enable communications with other users via write(1), layers
invokes the command relogin(1M) when the first layer is
created. relogin(1M) will reassign that layer as the user's
logged-in terminal. An alternative layer can be designated
by using relogin(1M) directly. layers will restore the ori-
ginal assignment on termination.
Layers are created, deleted, reshaped, and otherwise manipu-
lated in a terminal-dependent manner. For instance, the
AT&T TELETYPE 5620 DMD terminal provides a mouse-activated
pop-up menu of layer operations. The method of ending a
layers session is also defined by the terminal.
EXAMPLE
layers -f startup
where startup contains
8 8 700 200 date ; pwd ; exec $SHELL
8 300 780 850 exec $SHELL
NOTES
The xt(7) driver supports an alternate data transmission
scheme known as ENCODING MODE. This mode makes layers
operation possible even over data links which intercept con-
trol characters or do not transmit 8-bit characters. ENCOD-
ING MODE is selected either by setting a configuration
option on your windowing terminal or by setting the environ-
ment variable DMDLOAD to the value hex before running
layers:
export DMDLOAD; DMDLOAD=hex
If, after executing layers -f file, the terminal does not
respond in one or more of the layers, often the last command
in the command-list for that layer did not invoke a shell.
WARNING
When invoking layers with the -s, -t, -d, or -p options, it
is best to redirect standard error to another file to save
Rev. Base System Page 2
LAYERS(1) INTERACTIVE UNIX System LAYERS(1)
the statistics and tracing output (e.g., layers -s 2>stats);
otherwise all or some of the output may be lost.
FILES
/dev/xt??[0-7]
/usr/lib/layersys/lsys.8;7;3
/usr/lib/layersys/lsys.8;?;?
SEE ALSO
relogin(1M), sh(1), write(1), wtinit(1M), xts(1M), xtt(1M),
xt(7).
libwindows(3X), layers(5) in the INTERACTIVE SDS Guide and
Programmer's Reference Manual.
Rev. Base System Page 3