What is available ================= SRC Modula-3 is distributed via anonymous ftp from gatekeeper.dec.com. The distribution is in a set of compressed files in the directory named pub/DEC/Modula-3/release. The files are of the form -.tar.Z; in the rest of the chapter, we will speak of the archive archive and forget the version numbers. The archives boot. are used to build and install m3make, a driver and a compiler. These programs are built from intermediate C files that are architecture specific; you need to get the archive(s) corresponding to the architecture(s) on which you want to install SRC Modula-3. The supported architectures are: Arch | Hardware | OS | build | install | | | disk | cpu | disk ------------------------------------------------------------------------------ AIX386 | IBM PC | AIX/PS2 | | | AP3000 | Apollo DN4500 | Domain/OS 10.2 | | | ARM | Acorn R260 | RISC iX 1.21 | | | DS3100 | DECstation 5000/200 | Ultrix 4.2 | 23170 | 8 + 7 | 2758 HP300 | HP 9000/300 | HP-UX 7.0 | | | IBMR2 | IBM RISC System/6000 | AIX 3.1 | | | IBMRT | IBM RT | IBM/4.3 (AOS 4.3) | | | NEXT | NeXT | | | | SPARC | Sparcstation-1 | SunOS 4.1.x | | | SUN3 | Sun 3/? | SunOS ? | | | UMAX | Encore Multimax | UMAX 4.3 (R4.1.1) | | | VAX | VAX 8800 | Ultrix 4.2 | | | Each of these archives is about 4000 kilobytes. The column ``Build'' indicates the resources you need to build the two programs: ``disk'' is the amount of disk space (in kilobytes), ``cpu'' is the amount of user and system cpu time (in minutes). The column ``Install'' indicates the amount of disk space that will be permanently used after the installation is done (in kilobytes). The other archives contain Modula-3 source files for various libraries and programs. File | Build | Inst | Contents Name | size | disk |cpu | disk | ------------------------------------------------------------------------------- bicycle | | | | | card bitmaps for games, needs trestle compiler | 360 | 11255 | 17 | 0 | compiler sources data | 40 | 2693 | 3 | 856 | some generic container types demos | 80 | 10446 | 5 | 0 | demo programs, needs bicycle & pinecreek driver | 66 | | | 0 | driver sources doc | | | | | the documentation for SRC Modula-3 dpskit | | | | | Display PostScript binding interfaces dpsapps | | | | | Display PostScript applications formsvbt | | | | | FormsVBT, needs vbtkit libm3 | 1096 | 20374 | 12 | 5742 | base library m3make | 44 | | | 0 | make for Modula-3 tests | 336 | | | 0 | ``validation'' tests tools | 184 | 1746 | 1 | 548 | development tools, need trestle trestle | 416 | 13245 | 17 | 4048 | Trestle window system, needs X11R4 vbtkit | | | | | More VBTs, needs trestle vbtapps | | | | | FormsVBT applications, needs formsvbt X11R4 | 128 | 2906 | 5 | 1057 | binding interfaces to X11R4 The column ``File Size'' is the size (in kilobytes) of the compressed tar file. The colum ``Build'' indicates the resources you need to build and install these pieces of sources: ``disk'' is the amount of disk space (in kilobytes), ``cpu'' is the amount of user and system cpu time (in minutes). The column ``Install'' indicates the amount of disk space that will be permanently used after the installation is done; if you want to keep the sources around, you will need more space. These time and sizes have been measured on a DECstation 5000/200 running Ultrix 4.2; other architectures may have different requirements. You need to build and install libm3 to have a useful system, but all the other pieces are optional. The m3make and doc archives are also contained in the boot archives. Getting SRC Modula-3 ==================== In the following, $ is the shell prompt and ftp> is the ftp prompt. To get SRC Modula-3: 1. Make sure that you have enough disk space using the tables above. 2. Create a fresh directory for the software and go there. Path names below are relative to that directory, and it will be called the top-level directory: $ mkdir top-level $ cd top-level 3. Open an connection with gatekeeper.dec.com [16.1.0.2]; give anonymous for the name and your login id for the password: $ ftp gatekeeper.dec.com Connected to gatekeeper.dec.com. ... Name (gatekeeper.dec.com): anonymous Password (gatekeeper.dec.com:anonymous): your name@ your machine ... 4. Change to the proper directory: ftp> cd pub/DEC/Modula-3/release 5. Set the transmission type to binary: ftp> type binary 6. Get the files you want: ftp> get boot.-.tar.Z ftp> get libm3-.tar.Z ftp> get ... 7. Close the connection: ftp> quit 8. Uncompress and extract the files: $ zcat boot.-*.tar.Z | tar xpof - $ zcat libm3-*.tar.Z | tar xpof - $ ... The arguments specify the following options: x: extract the files from the file to the current directory p: restore files to their original modes o: override the original ownership, this makes you the owner of the files f: use the following argument (e.g -) as the input file; - as the input file means stdin You can add the v option to see what is going on. 9. At this point you may delete the archives to save space (the disk requirements indicated above assume that you do delete these files): $ rm *.tar.Z Installation procedure ====================== See the toplevel README for what do.