openwin(1)

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 server. openwin accepts the same command line options as xnews For more information, refer to the xnews manual page. In addition, openwin accepts the following command line arguments that xnews 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 the xnews manual page and OpenWindows documentation 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 the xnews manual page and OpenWindows documentation for more information. The X11/NeWS server 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).

XNEWS OPTIONS

Here is a listing of the options that you will find in the xnews man page:

[ :display ]

[ -auth authorization-file ]

[ -cubesize small | large ]

[ -escape ]

[ -defeateventsecurity ]

[ -favorstatic ]

[ -fp path,... ]

[ -help ]

[ -init ’POSTSCRIPT-code’ ]

[ -nobanner ]

[ -banner ]

[ -nominexp ]

[ -iobuffersize size ]

[ -sharedretainedpath ]

[ -nodev ]

[ -dev framebuffer ]

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

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

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

HELPPATH
xnews 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.

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

$HOME/.Xauthority and $HOME/.xnews.hostname:displaynumber
Files where per-session authorization information is written.

Museum

Related Articles