This example shows the installation of dstool for access by multiple system users. The central copy of the program libraries will be kept in the subdirectory dstool of the system directory /usr/local. To perform this installation, the user must have super-user privileges. The super-user prompt is the character ``#''. The system printer has the name ``sparc'' and, because of disk space considerations, the user chooses to construct a ``small'' build for the central dstool installation. Notice that the user begins by checking the definitions of the DSTOOL and OPENWINHOME variables, verifying the link path contains the OpenWindows libraries and setting the working directory to be DSTOOL/bin.
# pwd /usr/local/dstool # setenv DSTOOL=/usr/local/dstool DSTOOL_COLOR_DIR=/usr/local/dstool/colormaps ( only relevant variables DSTOOL_DATA_DIR=/marcy/guest/dstool are shown here ) LD_LIBRARY_PATH=/usr/local/openwin/lib LOGNAME=guest OPENWINHOME=/usr/local/openwin PATH=.: ...... :/usr/local/dstool/bin ( only /usr/local/dstool/bin # cd bin is shown here ) # ls -l total 13 -r-xr-xr-x 1 root 9026 Sep 26 08:25 install_dstool* -r-xr-xr-x 1 root 4022 Sep 26 08:25 install_dsuser* # install_dstool ################################################################ dstool installation script Cornell University Center for Applied Mathematics ################################################################ Several steps are involved in installing a copy of dstool onto a Sun workstation: 1. Check that the environment variables DSTOOL and OPENWINHOME have been defined and that $DSTOOL/bin has been added to the search path. 2. If this is a new installation, extract the source code from the distribution file. 3. Check that the paths defined in step 1 are sufficient to build a working program. 4. Change program characteristics that are specific to your working environment (printer name, etc..). 5. Compile and link the dstool executable This installation program automates the installation of dstool, using responses from the user. The installation directory for dstool is controlled by the environment variable DSTOOL. You MUST have DSTOOL defined to proceed with the program installation. Currently, DSTOOL is set to the path: /usr/local/dstool Do you want to proceed to install the dstool program in /usr/local/dstool?: (yes or no): yes During the process of compiling dstool, several files and libraries are required from the OpenWindows package. The search for these files is controlled by the environment variable OPENWINHOME and the addition of: $OPENWINHOME/lib to the library search path. OPENWINHOME is set to: /usr/local/openwin If this is not correct, please exit and consult the dstool installation document or the OpenWindows users guides for more information on setting up your Windows environment. Continue with the installation (yes or no): yes Extracting the dstool source...please wait. x Makefile, 942 bytes, 2 tape blocks x colormaps/colormap, 1392 bytes, 3 tape blocks x colormaps/colortable_alt, 421 bytes, 1 tape blocks x colormaps/colortable_id, 549 bytes, 2 tape blocks x colormaps/sys_colormap, 64 bytes, 1 tape blocks x colormaps/colortable_inv, 550 bytes, 2 tape blocks x site_specific/lib_incl.mk, 196 bytes, 1 tape blocks x site_specific/Prolog.ps, 4563 bytes, 9 tape blocks : : ( many lines of output appear ) : x site_specific/cleanup.mk, 227 bytes, 1 tape blocks x site_specific/targets.mk, 985 bytes, 2 tape blocks x src/windows/twoD_opt/twoD_opt_hnd.c, 5205 bytes, 11 tape blocks x src/windows/Makefile, 670 bytes, 2 tape blocks x src/windows/ui_init.c, 4520 bytes, 9 tape blocks x src/Makefile, 1757 bytes, 4 tape blocks x src/dstool.c, 3260 bytes, 7 tape blocks Checking the paths and libraries...please wait. No match. cd /usr/local/dstool/src/guide ; make guidelib.a cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows -I/usr/local/dstool/src/include -c gdd.c -o gdd.o cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows -I/usr/local/dstool/src/include -c gcm.c -o gcm.o ar rv guidelib.a gdd.o gcm.o a - gdd.o a - gcm.o ar: creating guidelib.a ranlib guidelib.a cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows -I/usr/local/dstool/src/include -c libtest.c -o libtest.o cc -O -I/usr/local/openwin_2.0/include -O -target sun4 libtest.o /usr/local/dstool/src/guide/guidelib.a -O -lxview -lolgx -L/usr/local/openwin_2.0/lib -lX -lm -o /usr/local/dstool/install/libtest [1] 5325 The automatic test of the system library paths is completed. Do you want to continue (y/n) ? yes [1] Killed libtest The default printer name is currently: lp. Do you want to use this printer name? (yes or no): no Enter new printer name: sparc The default printer name is currently: sparc. Do you want to use this printer name? (yes or no): yes Filesystem kbytes used avail capacity Mounted on /dev/sd0a 7508 4916 1841 73% / /dev/sd0g 74722 65830 1419 98% /usr swap 4720 52 46681% /tmp macomb:/usr/local 316674 264813 20193 93% /usr/local You may select one of the following installation options: full Installs all of the dstool source and library files. This option requires approximately 9.5 Mbytes of disk space. small Installs only the libraries and essential dstool source required to add new dynamical systems. Enter installation type (full or small): small Making the dstool executable... cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows -I/usr/local/dstool/src/include -c /usr/local/dstool/src/dstool.c -o /usr/local/dstool/src/dstool.o ar rv /usr/local/dstool/src/mainlib.a /usr/local/dstool/src/dstool.o a - /usr/local/dstool/src/dstool.o ar: creating /usr/local/dstool/src/mainlib.a ranlib /usr/local/dstool/src/mainlib.a : : ( many lines of output appear ) : example.o ar rv userlib.a user_panels.o mult_proj.o example.o a - user_panels.o a - mult_proj.o a - example.o ar: creating userlib.a ranlib userlib.a cc -O -I/usr/local/openwin_2.0/include -O -target sun4 /usr/local/dstool/src/mainlib.a /usr/local/dstool/src/config/configlib.a /usr/local/dstool/src/windows/uilib.a /usr/local/dstool/src/windows/cmd/cmdlib.a /usr/local/dstool/src/windows/twoD/twoDlib.a /usr/local/dstool/src/windows/defaults/defaultslib.a /usr/local/dstool/src/windows/periodic/periodiclib.a /usr/local/dstool/src/windows/save/savelib.a /usr/local/dstool/src/windows/load/loadlib.a /usr/local/dstool/src/windows/print/printlib.a /usr/local/dstool/src/windows/function/functionlib.a /usr/local/dstool/src/windows/mult/multlib.a /usr/local/dstool/src/windows/orbit/orbitlib.a /usr/local/dstool/src/windows/prop/proplib.a /usr/local/dstool/src/computation/complib/complib.a /usr/local/dstool/src/windows/selected/selectlib.a /usr/local/dstool/src/computation/fixptlib/fixptlib.a /usr/local/dstool/src/computation/eigenlib/eigenlib.a /usr/local/dstool/src/storage/memory/memorylib.a /usr/local/dstool/src/storage/storagelib.a /usr/local/dstool/src/utilities/utillib.a /usr/local/dstool/src/guide/guidelib.a /usr/local/dstool/src/models/modellib.a /usr/local/dstool/src/userlib/userlib.a -O -lxview -lolgx -L/usr/local/openwin_2.0/lib -lX -lm -o /usr/local/dstool/bin/dstool Making the dstool libraries... cd /usr/local/dstool/src/config ; make configlib.a `configlib.a' is up to date. cd /usr/local/dstool/src/windows ; make uilib.a `uilib.a' is up to date. cd /usr/local/dstool/src/windows/cmd ; make cmdlib.a `cmdlib.a' is up to date. : : ( many lines of output appear ) : cd /usr/local/dstool/src/models ; make modellib.a `modellib.a' is up to date. cd /usr/local/dstool/src/userlib ; make userlib.a `userlib.a' is up to date. for i in /usr/local/dstool/src/mainlib.a /usr/local/dstool/src/config/configlib.a /usr/local/dstool/src/windows/uilib.a /usr/local/dstool/src/windows/cmd/cmdlib.a /usr/local/dstool/src/windows/twoD/twoDlib.a /usr/local/dstool/src/windows/defaults/defaultslib.a /usr/local/dstool/src/windows/periodic/periodiclib.a /usr/local/dstool/src/windows/save/savelib.a /usr/local/dstool/src/windows/load/loadlib.a /usr/local/dstool/src/windows/print/printlib.a /usr/local/dstool/src/windows/function/functionlib.a /usr/local/dstool/src/windows/mult/multlib.a /usr/local/dstool/src/windows/orbit/orbitlib.a /usr/local/dstool/src/windows/prop/proplib.a /usr/local/dstool/src/computation/complib/complib.a /usr/local/dstool/src/windows/selected/selectlib.a /usr/local/dstool/src/computation/fixptlib/fixptlib.a /usr/local/dstool/src/computation/eigenlib/eigenlib.a /usr/local/dstool/src/storage/memory/memorylib.a /usr/local/dstool/src/storage/storagelib.a /usr/local/dstool/src/utilities/utillib.a /usr/local/dstool/src/guide/guidelib.a /usr/local/dstool/src/models/modellib.a /usr/local/dstool/src/userlib/userlib.a; do \ (cp $i /usr/local/dstool/libraries); \ done ranlib -t /usr/local/dstool/libraries/*.a Installation of dstool is complete.