OPENWIN(1) — USER COMMANDS

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 xnews(1) window server, olwm(1) X11 ICCCM OpenLook window manager, and several default DeskSet(tm) tools.

OPTIONS

There are several options which allow you to tailor the default setup of the xnews(1) server. openwin accepts the same command line options as xnews(1). For more information, refer to the xnews(1) manual page. In addition, openwin accepts the following command line arguments that xnews(1) does not accept:

[-server xnews]
This tells openwin which server binary to start. The default is $OPENWINHOME/bin/xnews.

[-noauth]
This tells openwin to start the X11/NeWS server with authorization checking turned off. The default is to run with authorization enabled. Running the X11/NeWS server with this option enabled, lowers your level of security. It is recommended that this option be not enabled, except when explicitly needed. See xnews(1) manual page for more information.

ENVIRONMENT

The behavior of openwin can also be tailored by means of the following environment variables:

OPENWINHOME
Should be set to the directory in which the server’s directory hierarchy is installed, for instance "/usr/local/xnews". Below this directory are the binaries, libraries, fonts, man pages and demos. If this is not set the default is "/home/openwin". Under most circumstances this is the only variable which needs to be set to run OpenWindows.

DISPLAY
By default this is ":0" meaning this xnews server is the first (zero based) one running on this machine. If you need to run more that one server on a given machine, use the "-display" option.

LD_LIBRARY_PATH
This variable is used by the shared library linker to determine which directories to examine for shared libraries. The openwin shell script prepends $OPENWINHOME/lib to this path.

PATH
This is the path searched by shells (i.e. csh, sh, ksh) to find executable programs. $OPENWINHOME/bin and $OPENWINHOME/bin/xview are prepended to your path if they were not there already.

NEWSSERVER
The proper value for running NeWS clients given the specification of the -display argument is put into the environment in NEWSSERVER.

FONTPATH
xnews(1) searches this path for fonts, $OPENWINHOME/lib/fonts is appended to any existing definition of FONTPATH.

MANPATH
xnews(1) searches this path for man pages, $OPENWINHOME/share/man is appended to any existing definition of MANPATH.

HELPPATH
xnews(1) searches this path for help files, $OPENWINHOME/lib/help is appended to any existing definition of HELPPATH.

FILES

~/.xinitrc
This is the file executed by xinit(1) after the server is up and running. If the user does not have a .xinitrc, then a default one is copied from $OPENWINHOME/lib/Xinitrc which contains the following:

# .xinitrc - OpenWindows startup script.
if [ -f $HOME/.Xdefaults ]; then
    xrdb $HOME/.Xdefaults &# Load Users X11 resource database
else
    xrdb $OPENWINHOME/lib/Xdefaults & # Load Default X11 resource database
fi
$OPENWINHOME/lib/openwin-sys &# OpenWindows system initialization
eval ‘svenv -env‘# SunView binary compatibility
olwm -3 &# OpenLook Window Manager
if [ -x $HOME/.openwin-init ]; then
    $HOME/.openwin-init# Custom OpenWindows tools
else
    $OPENWINHOME/lib/openwin-init    # Default OpenWindows tools
fi
wait

If the system is configured with multiple OpenWindows screens by supplying multiple -dev command line options (see xnews(1)), you need to modify .xinitrc to have multiple invocations of the window manager and svenv. The following is an example:

# .xinitrc - OpenWindows startup script for 2 screens.
if [ -f $HOME/.Xdefaults ]; then
    xrdb $HOME/.Xdefaults &# Load Users X11 resource database
else
    xrdb $OPENWINHOME/lib/Xdefaults & # Load Default X11 resource database
fi
$OPENWINHOME/lib/openwin-sys & # OpenWindows system initialization
eval ‘svenv -display :0.0 -env‘# SunView binary compatibility (screen 1)
olwm -display :0.0 -3 &# OpenLook Window Manager (screen 1)
eval ‘svenv -display :0.1 -env‘# SunView binary compatibility (screen 2)
olwm -display :0.1 -3 &# OpenLook Window Manager (screen 2)
if [ -x $HOME/.openwin-init ]; then
    $HOME/.openwin-init# Custom OpenWindows tools
else
    $OPENWINHOME/lib/openwin-init   # Default OpenWindows tools
fi
wait

~/.Xdefaults
This is where X11 application resources are defined, if this file does not exist it is copied from $OPENWINHOME/lib/Xdefaults.

$OPENWINHOME/lib/Xinitrc
Site specific changes to the default .xinitrc can be made here and will be propagated to users without an existing .xinitrc.

$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.

Museum

Related Articles