NAME
openwin - OpenWindows startup script
SYNOPSIS
openwin [ options ]
DESCRIPTION
The openwin shell script sets up the proper environment for
starting the entire OpenWindows package, including the
Xsun(1) window server, olwm(1) an X11 ICCCM and OpenLook
compliant window manager, and several default DeskSet(tm)
tools.
OPTIONS
There are several options which allow you to tailor the
default setup of the Xsun server. openwin accepts the same
command line options as Xsun. For more information, refer to
both the Xsun(1) and Xserver(1) manual pages. Note that
options passed to the server by the openwin shell script
such as -r may be overwritten by settings specified by
props(1) as it initializes the desktop. See the props(1)
man page for more details.
In addition, openwin accepts the following command line
arguments that the server does not accept:
[-server Xsun]
This tells openwin which server binary to start. The
default is $OPENWINHOME/bin/Xsun.
[-noauth]
The OpenWindows server implements the "MIT-MAGIC-
COOKIE" security mechanism which is a user-specific,
rather than host-specific, authorization system. The
default is to run with this authorization enabled.
This option tells openwin to start the server without
the "MAGIC COOKIE" authorization and will revert to no
user-specific security. Running the server with this
option enabled lowers your level of security. It is
recommended that this option not be enabled, except
when explicitly needed. See the OpenWindows documenta-
tion for more information.
[-auth protocol-name]
This option allows the user to choose the authentica-
tion protocol that the server will use to authenticate
client connections. The two choices available are
magic-cookie, or sun-des. The former sets the authenti-
cation protocol to "MIT-MAGIC-COOKIE" and is the
default, while the latter makes the server use "SUN-
DES-1", which is based on SecureRPC, as the authentica-
tion protocol. See the OpenWindows documentation for
more information.
[-includedemo]
This option indicates that the path to the demo direc-
tory should be included in the user's search path (see
PATH below).
[-wm wm-command]
This option allows the user to choose an alternate win-
dow manager to be started by the system default Xin-
itrc. The default is to start olwm(1) (the OpenLook
window manager). For example, the command "openwin -wm
twm" will start twm(1) instead of olwm. A wm-command of
multiple words must be quoted. This option is likely
to be ignored if the user has a $HOME/.xinitrc script
of their own.
ENVIRONMENT
The behavior of openwin can also be tailored by means of the
following environment variables:
OPENWINHOME
The OPENWINHOME variable is no longer required to be
set. OpenWindows should always be accessible from
/usr/openwin. If OPENWINHOME is set to anything other
than /usr/openwin, OpenWindows will not start up prop-
erly.
DISPLAY
By default this is ":0", meaning this server is the
first (zero based) one running on this machine. If you
need to run more than one server on a given machine,
use the -display option.
LD_LIBRARY_PATH
OpenWindows will no longer set LD_LIBRARY_PATH. Appli-
cations requiring the OpenWindows libraries should be
compiled with LD_RUN_PATH set to /usr/openwin/lib. If
you find an older binary which was compiled without
LD_RUN_PATH set, you will need to set LD_LIBRARY_PATH
to $OPENWINHOME/lib in order to execute this program.
PATH
This is the path searched by shells (i.e. csh(1),
sh(1), and ksh(1)) to find executable programs.
$OPENWINHOME/bin is prepended to your path if it is not
there already.
MANPATH
openwin will add $OPENWINHOME/share/man to MANPATH so
that OpenWindows manual pages will be available to the
user through the man(1) command.
HELPPATH
OpenWindows searches this path for help files,
$OPENWINHOME/lib/help is appended to any existing
definition of HELPPATH.
OW_WINDOW_MANAGER
Specifies an alternate window manager command to be
used by the system default Xinitrc script. This
environment variable is private to the startup scripts
and should not be used or set directly.
XINITRC
Specifies an init script executed by xinit(1) after the
server is up and running. If $HOME/.xinitrc does not
exist and XINITRC is not already set, it is set to
$OPENWINHOME/lib/Xinitrc.
HOME
The name of the user's login directory, set by login(1)
from the password file /etc/passwd (see passwd(1)).
FILES
$HOME/.xinitrc
This is the file executed by xinit after the server is
up and running. Previous releases copied
$OPENWINHOME/lib/Xinitrc into $HOME/.xinitrc. This is
no longer necessary and only users who want to custom-
ize server startup need to have this file.
$HOME/.Xdefaults
This is where X11 application resources are defined.
The default Xinitrc script will use .Xdefaults if it
exists, or use $OPENWINHOME/lib/Xdefaults if it does
not exist.
$OPENWINHOME/lib/Xinitrc
The default xinit init script. Site specific changes
can be made here and will be used by users without an
existing .xinitrc. The default Xinitrc contains the
following:
# @(#)Xinitrc 1.20 92/12/08 OpenWindows startup script.
xrdb $OPENWINHOME/lib/Xdefaults # Load Default X11 resource
database
if [ -f $HOME/.Xdefaults ]; then
xrdb -merge $HOME/.Xdefaults # Load Users X11 resource
database
fi
$OPENWINHOME/lib/openwin-sys # OpenWindows system
initialization
eval `locale_env -env` # Set Locale Environment
if [ "$OW_WINDOW_MANAGER" ]; then # Alternate Window Manager
xsetroot -def # Clear root window
$OW_WINDOW_MANAGER & wmpid=$! # Start Alt Window Manager
dsdm & # OpenLook Drop Site Database
unset OW_WINDOW_MANAGER
else
sleep 15 & pid=$! # OpenLook Window Manager
olwm -syncpid $pid & wmpid=$!
wait $pid # Pause until olwm inits
fi
if [ -x $HOME/.openwin-init ]; then
$HOME/.openwin-init # Custom OpenWindows tools
else
$OPENWINHOME/lib/openwin-init # Default OpenWindows tools
fi
wait $wmpid # Wait for wm (key client) to exit
$OPENWINHOME/lib/Xdefaults
Site specific changes to the default resource database
can be made here and will be propagated to users
without an existing .Xdefaults.
$HOME/.Xauthority and $HOME/.xsun.hostname:displaynumber
Files where per-session authorization information is
written.
SEE ALSO
Xsun(1), Xserver(1), login(1), olwm(1), passwd(1), props(1),
xinit(1), xrdb(1)
NOTES
The OpenWindows environment may no longer be supported in a
future release. You may want to migrate to CDE, the Common
Desktop Environment.
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |