XTDSTART(1) X11 R4.11MU05 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 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 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
existence 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)