This page describes the HDSrunwm utility program used to launch window
manager processes on the ViewStation.
HDSrunwm Launcher Program
The `hdsrunwm' program provides an alternate way of starting a
local window manager on an HDS ViewStation. If the `hdsrunwm' program
is used on the host to start the ViewStation window manager, any window
manager menu commands will also be started by the `hdsrunwm' program.
This allows these menu commands to inherit the same environment as they
would if the window manager were being run on the host.
The `hdsrunwm' program requires HDSware Version 3.0.3 or
later.
To use the `hdsrunwm' program:
1. Check the hds-fx/contrib/hdsrunwm/execs directory for an
executable suitable for your host type. If you find one, use the
`uncompress' command on the file.
For example,
uncompress hdsrunwm.SUN4.Z
mv hdsrunwm.SUN4
hdsrunwm
You may need to set the `executable' permissions for
the file. For this, you can use the command: chmod +x hdsrunwm
2. If a suitable executable does not already exist for your
host type, set the current directory to hds-fx/contrib/hdsrunwm/src.
The `hdsrunwm.c' source can be used to compile an executable for your
host.
You will need to know the name of the Remote Shell program on
your host. For many machines, this is `rsh'. On some System V machines
the program is `rcmd'. On some HP systems it is `remsh'.
Edit the
`hdsrunwm.c' source file and set the REMOTE_SHELL_PROGRAM definition
appropriately.
To compile, execute the command:
cc -o hdsrunwm hdsrunwm.c
If you are using an alternate compiler, such as GNU/C, you may
need to use a command such as `gcc'. This will produce a `hdsrunwm'
executable file.
3. Copy the `hdsrunwm' file into a directory which will be
included in your execute search path when you want to start the window
manager. Possibilities include /bin, /usr/bin/X11, /usr/local/bin, etc.
4. The `hdsrunwm' program uses the DISPLAY environment
variable to determine the hostname of the ViewStation on which to start
the window manager.
The `hdsrunwm' uses the Remote Shell program to start the
command. Most Remote Shell programs require a valid hostname instead of
a numeric IP address. Therefore, if your Remote Shell program requires
a hostname (as most do), make sure your DISPLAY environment variable
will contain a hostname and not simply an IP address.
The `hdsrunwm' program will print a warning message if a
number IP address is present in the DISPLAY variable.
5. Where you would normally start your window manager,
substitute the `hdsrunwm' command. For example, if you start your `mwm'
in the .xsession file, replace the line mwm -option1 -option2 -option3
with hdsrunwm mwm -option1 -option2 -option3
Return to Section Heading Page
Return to the Home Page
If you need more information than is available here, you can reach
HDS via email at info@hds.com, or
call us at 1.800.HDS.1551 in the USA, or at +610.277.8300 from outside
the US. For questions or problems regarding the HDS WWW page, contact
webmaster@hds.com.
© 1996 by HDS Network Systems
Inc.