XTDSTART(1) X Version 11 (Release 5) XTDSTART(1)
NAME
xtdstart - start X Windows on an X terminal display
SYNOPSIS
xtdstart [ -xdefaults ResourceFile ] [ -client
ProgramOrShellscript ] [ -log ErrorLogFile ] [ -keymap
KeymapFile ] [ -nokeymap ] [ -display hostname ]
DESCRIPTION
Xtdstart begins a set of X client applications on an X
terminal display, e.g., an AVX-30 display terminal. It
establishes a standard set of resources, establishes the
proper execution environment, and starts a shell script or
program to initiate X client applications.
Options can be specified in one of four ways: the command
line, a personal resource database file, the system's
resource database file, or defaulted by xtdstart itself.
All options on the command line must be preceded by a dash
and have white space separating the option name and value.
Options in files must be preceded by "xtdstart.", and have a
colon separating the option name and value.
The following command line options are available:
-xdefaults ResourceFile
ResourceFile specifies a location from which
to read the personal resource database,
instead of $HOME/.Xdefaults. If specified
on the command line, this must be the first
option.
-client ProgramOrShellscript
ProgramOrShellscript is the name of a shell
script or program file that will be run by
xtdstart after it has initialized the X
terminal display. This script or program is
expected to start a set of X clients. If
this option is not specified, then
/usr/lib/X11/app-defaults/xstart.sh is used.
-log ErrorLogFile
ErrorLogFile specifies a file other than
$HOME/Xerrors into which error messages are
to be logged.
-keymap KeymapFile
KeymapFile specifies a file other than
$HOME/.Xkeymap from which key mapping
information is to be taken.
-nokeymap This option indicates that no key mapping
Licensed material--property of copyright holder(s) Page 1
XTDSTART(1) X Version 11 (Release 5) XTDSTART(1)
should take place. If this is not specified
and a key mapping file exists, then the
xmodmap program will be run to define the
key mapping.
-display hostname[:0]
The display option is used to set the
DISPLAY environment variable (see below).
If the variable is not set and exported
before invoking xtdstart and if this option
is not specified, then xtdstart will ask the
user to enter a hostname.
The options client, log, keymap, nokeymap, and display may
be specified in either the personal or the system's resource
database files. An option specified on the command line has
precedence; if not specified there, then the option in the
personal resource database is used; if not specified there,
then the option in the system resource database is used; or
finally the program will select a value for unspecified
options.
These environment variables are made available for client
applications:
DISPLAY This variable has the format
"hostname:display" where display is
typically 0. The hostname is the name by
which the X terminal is known to the
network. Xtdstart adds the ":0" suffix if
the display is specified without it.
XLOGFILE This variable is set to the name of the file
to which errors are written by xtdstart
itself and by the various clients. A client
application may wish to display this file.
TERM The terminal type is set to xterm.
PATH The X bin and lib directories are added to
the current PATH variable if they are not
already there.
xtdstart runs xrdb to set the contents of the
RESOURCE_MANAGER property on the root window. Resources set
by xrdb will be read first from /usr/lib/X11/app-
defaults/Xdefaults and then from $HOME/.Xdefaults (or from
the file specified with the -xdefaults option on the command
line), with the information from the /usr/lib/X11/app-
defaults/Xdefaults file having lower priority.
xmodmap is used to establish key mappings if a key mapping
Licensed material--property of copyright holder(s) Page 2
XTDSTART(1) X Version 11 (Release 5) XTDSTART(1)
file exists and the -nokeymap option is not specified. The
key mapping file is determined from the resource
specifications; $HOME/.Xkeymap is used if it exists and the
resource specifications do not identify an alternative. If
-keymap is specified on the command line, the existance of a
nokeymap option in a resource file is ignored and the key
mapping is loaded.
EXAMPLES
This is a typical invocation:
xtdstart -display myhost
The above invocation would use the default client script or
program, the default error log file, and the default
resource database files.
This is a sample client script:
#!/bin/sh
uwm &
xterm -vb -geometry 80x24+10-10 &
xclock -analog &
xbiff &
This is a sample section of a personal .Xdefaults file:
xtdstart.client: $HOME/bin/xclients
xtdstart.display: myhost
xtdstart.keymap: ~/.mykeymap
xtdstart.nokeymap: false
FILES
/usr/bin/X11 directory containing X client
applications
/usr/lib/X11/app-defaults/Xdefaults
system resource specification
/usr/lib/X11/app-defaults/xstart.sh
default client start-up script
$HOME/.Xdefaults default location of personal resource
specification
$HOME/.Xkeymap default location of keymap information
$HOME/X_errors default location for writing error
messages
SEE ALSO
X(1), xstart(1), xmodmap(1), xrdb(1).
COPYRIGHT
Data General Corporation, 1989.
See X(1) for a full statement of rights and permissions.
Licensed material--property of copyright holder(s) Page 3