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) 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 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]
The X11/NeWS server now 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 tells openwin to start the X11/NeWS server without the "MAGIC COOKIE" authorization and will revert to the security mode of previous X11/NeWS server versions. Running the X11/NeWS server with this option enabled, lowers your level of security. It is recommended that this option not be enabled, except when explicitly needed. See xnews(1) manual page and the X11/NeWS Server Guide for more information.

[-auth protocol-name]
This option allows the user to choose the authentication protocol that X11/NeWS server should use to authenticate client connections. The two choices available are magic-cookie, or sun-des. The former sets the authentication protocol to "MIT-MAGIC-COOKIE" and is the default, while the latter makes the X11/NeWS server use "SUN-DES-1", which is based on SecureRPC, as the authentication protocol. See xnews(1) manual page and the X11/NeWS Server Guide for more information. The X11/NeWS server now implements the "MIT-MAGIC-COOKIE" security.

[-includedemo]
This option indicates that the path to the demo directory should be included in the user’s search path (see PATH below).

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 than 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. When specifying the -nosunview option, the openwin shell script will also append $OPENWINHOME/lib/server to this path.

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

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.

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.

FILES

~/.xinitrc
This is the file executed by xinit(1) 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.

~/.Xdefaults
This is where X11 application resources are defined. The default Xinitrc script will use .Xdefaults it if exists or use $OPENWINHOME/lib/Xdefaults if it doesn’t.

$OPENWINHOME/lib/Xinitrc
The default xinit(1) 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 - OpenWindows startup script.
if [ -f "/usr/lib/cpp" -o -f "/usr/ccs/lib/cpp" ]
then
    if [ -f "/usr/ccs/lib/cpp" ]
    then
        XRDB="xrdb -cpp /usr/ccs/lib/cpp"
    else
        XRDB="xrdb -cpp /usr/lib/cpp"
    fi
else
    XRDB="xrdb -nocpp"
fi
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 &# 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# Wait for olwm (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.

Museum

Related Articles