openwin Man Page: openwin(1)

Man Pages

Back to Software Index BORDER=0

Manpage Top Level

openwin(1) manual page Table of Contents

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 magic-cookie, or sun-des. The former sets the authentication 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 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 /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 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.

Name

Synopsis

Description

Options

Environment

Files

See Also