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 documentation for more information.

[-auth protocol-name]

This option allows the user to choose the authentication protocol that the server will use to authenticate client connections. The two choices available are magiccookie ,or sun-des. The former sets the authentication protocol to "MITMAGIC-COOKIE" and is the default, while the latter makes the server use "SUN-DES-1", which is based on SecureRPC, as the authentication protocol. See the OpenWindows documentation for more information.

[-includedemo]

This option indicates that the path to the demo directory should be included in the user's search path (see PATH below).

[-wm wm-command]

This option allows the user to choose an alternate window manager to be started by the system default Xinitrc. 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 properly.

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. Applications 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 /binis 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 customize 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)