diff options
Diffstat (limited to 'doc/ports/sun2_032786.doc')
| -rw-r--r-- | doc/ports/sun2_032786.doc | 152 |
1 files changed, 152 insertions, 0 deletions
diff --git a/doc/ports/sun2_032786.doc b/doc/ports/sun2_032786.doc new file mode 100644 index 00000000..298139db --- /dev/null +++ b/doc/ports/sun2_032786.doc @@ -0,0 +1,152 @@ +SUN/IRAF V2.2 Installation, 6 March 1986 Sun-2, software floating point +------------------------------------------------------------------------------ + +/usr/iraf/***** +/usr/iraf + Located IRAF root directory at /usr/iraf, created iraf/local + for personal file storage. Unpacked tar archive of v2.2, 6 Mar + version, from master VAX/UNIX system "lyra". (3/6) + +/usr/iraf/local/ + Unpacked earlier Sun archive of /usr/iraf/local; this contains + development stuff for Sun graphics kernels, plus the .login file + for the IRAF account. It is important that this file sources + $iraf/unix/hlib/irafuser.csh to pick up environment definitions + and aliases. Make sure iraf root and home directories match + the real thing. (3/6) + +unix/as +unix/as/ishift.s +unix/as/zsvjmp.s + Moved the VAX as/ to unix/vaxas. Created an empty unix/as and + copied the two SUN .s files into it from unix/mc68000. (3/6) + +unix/hlib/mach.h +unix/hlib/libc/spp.h + Set EPSILONR and EPSILOND for the SUN as in unix/mc68000/README. + Set BYTE_SWAP2 and BYTE_SWAP4 to NO in mach.h. (3/6) + +unix/hlib/mkmlist.csh + Changed bgrep to grep, since bgrep not available in standard + UNIX. (Not important, doesn't have to work, so the efficiency + of bgrep on the development machine is worth the mach. dependence.) + (3/6) + +home$.login +unix/hlib/mkiraf.csh +unix/hlib/libc/iraf.h + Changed all occurrences of iraf root directory pathname. (3/6) + +unix/hlib/mkpkg.inc + Set USE_CALCOMP to no. (3/6) + +/usr/include/iraf.h -> $hlib/libc/iraf.h + Establish this symbolic link as superuser (i.e. %su; cd /usr/include; + ln -s $hlib/libc/iraf.h iraf.h). This is necessary for compiling + IRAF programs. (3/6) + +TODO: unix/hlib/[dif]mach.f + These files were NOT set up for the Sun, since we did not have the + values, but this should be done later. Once modified, a mkpkg at the + root will recompile all affected programs. + +TODO: unix/as/*.x + It would be nice to have some additional assembler modules for + efficiency reasons. See unix/vaxas. Coding of these can be left + for later. + + +/usr/iraf/hlib/libc/kernel.h + Commented out DEBUGMEM in order to use the standard UNIX malloc rather + than IRAF's version. This is necessary for some reason on the Sun for + SunCGI programs to be callable from SPP programs. (3/6) + +------------------------------------------------------------------------------ +That completes the initial setup. Now we bootstrap the system. + + % cd $iraf/unix + % sh -x mkpkg.csh >& spool & + +This builds all the bootstrap utilities, then as a final step compiles the +portion of LIBSYS in host/gdev, which exercises MKPKG, XC, etc. If all that +works things are in excellent shape. (3/6) + +/usr/bin/alloc -> $hlib/alloc.e +/usr/bin/generic -> $hlib/generic.e +/usr/bin/mkpkg -> $hlib/mkpkg.e +/usr/bin/rmbin -> $hlib/rmbin.e +/usr/bin/rmfiles -> $hlib/rmfiles.e +/usr/bin/rtar -> $hlib/rtar.e +/usr/bin/wtar -> $hlib/wtar.e +/usr/bin/xc -> $hlib/xc.e + Establish these symbolic links as superuser (e.g. cd /usr/include; + ln -s $hlib/mkiraf.csh mkiraf). These are required for regular + users who do not have a .cshrc or .login which sources + $iraf/unix/hlib/irafuser.csh, for running the cl or mkiraf. + Ordinarily we only link xc, mkiraf, and mkpkg here, but since we're + doing development on the Sun outside IRAF, the rest are useful. (3/6) + +unix/hlib/alloc.e + This file must belong to root, since it needs root permissions at + runtime to allocate devices. Do the following: + + % cd $hlib + % su + % /etc/chown 0 alloc.e (3/6) + +------------------------------------------- +The bootstrap is now complete. The next step is to do a full system compile. + +There are 5 files that need to be hand-compiled without optimization (from +previous experience on the SUN) to avoid getting in an infinite loop in pass +c2 of the compiler. "xc -c" each file to create an object file in its +directory; mkpkg will then avoid recompiling it. Note: see local/bugs +README for description of "-P" for partial optimization instead. + + sys/fio/fstati.x + math/bevington/matinv.f + sys/gio/nspp/portlib/gridal.f + sys/ki/irafks.x + pkg/twodspec/longslit/transform/igsfit/igsfit.f + +(The last file wasn't included in the initial hand-compile, but stalled +the later sysgen in an infinite loop; placed here for completeness next time.) +Now perform the full system compile (sysgen). + + % cd $iraf + % mkpkg >& spool & (3/6) + + The sysgen was started at 17:02 on March 6, 1986. It stalled at 9:47 + Friday March 7, in an infinite loop in: + pkg$twodspec/longslit/transform/igsfit/igsfit.f + I hand-compiled it and restarted the sysgen at 13:30, renaming the first + spool file spool1. (3/7) + + The sysgen finished at 15:53 with no further errors (the "Termination + code 9" in $iraf/spool is due to another stall in igsfit -- I had + hand-compiled the wrong file, so mkpkg stalled again; this time I just + killed the lowest-level process and ran mkpkg from longslit/transform + by hand during the main sysgen, and later checked that there weren't + any collision problems). + + Clock time was thus 19:08 hours, but at least 5 of these hours saw two + interactive users (mostly editing, but some compiling) competing for + resources. (3/7) + +/usr/bin/xc -> $hlib/xc.e + Established this symbolic link as superuser, now what we have a + CL in $iraf/bin. This completes the software-building part of the + installation. (3/7) + +unix/as/ishift.s + Would not do a right shift, since the 68010 uses two different + instructions to do left and right shifts, unlike the vax, which + allows the shift argument to be negative. Changed to use the ROL + and ROR instructions. (3/14) + +sys/gio/stdgraph/stgdrawch.x + When stdgraph kernel attempted to draw high-quality text, it + began drawing lines and garbage text all over the screen until it + hit a segmentation violation. Traced to module sgch_flush(), + "call stg_polyline (pl, op / 2)", (SHORT op), where stg_polyline + wanted an INT for the 2nd argument. Changed to "int (op / 2)". (3/27) |