A OBTAINING CONFIGURATION SOFTWARE ____________________________________________________________ Copyright c 1993 O'Reilly and Associates, Inc. All rights reserved. Permission is granted to copy this document for personal use only. This copyright notice must be retained in all copies. This appendix describes how to obtain the software discussed in this book. All distributions listed below are available as compressed tar files. imake.tar.Z The configuration software described in this book. The distribution contains imake, xmkmf, imboot, makedepend, mkdirhier, msub, bsdinst, imdent, the X11 configuration files, and some other miscellaneous utilities. Instructions for building and installing this distribu- tion are given in Appendix B, Installing Configuration Software. TOUR.tar.Z The examples in Chapter 2, A Tour of imake, are based on the X11 configuration files. TOUR.tar.Z contains an alternate set of configuration files that can be used for the examples. They're similar to the X files, but simplified to be easier to understand. SP.tar.Z The starter project files described in Chapter 8, A Configuration Starter Project. DP.tar.Z The demonstration project files developed in Chapter 10, Introduction to Configuration File Writing, and Chapter 11, Writing Rule Macros. EA.tar.Z The configuration files implementing the extensible architecture described in Chapter 14, Designing Exten- sible Configuration Files, and Chapter 15, Creating Extensible Configuration Files. DECUS-cpp.tar.Z Two alternative implementations of cpp. You might find them useful if your C preprocessor doesn't work with - Copyright c 1993 O'Reilly & Associates. All rights reserved. - Obtaining Configuration Software A-1 imake. bookcf.tar.Z The configuration files used in connection with the writing of Software Portability with imake. Errata.tar.Z Last and, I hope, least, the current list of known errors in this book. Obtaining the Distributions The software is available electronically in a number of ways: by FTP, GOPHER, FTPMAIL, BITFTP, and UUCP. The cheapest, fastest, and easiest ways are listed first. The first one that works for you is probably the best. Use FTP or GOPHER if you are directly on the Internet. Use FTPMAIL if you are not on the Internet but can send and receive electronic mail to Internet sites (this includes CompuServe users). Use BITFTP if you send electronic mail via BITNET. Use UUCP if none of the above works. FTP To use FTP, you need a machine with direct access to the Internet. The software may be obtained from any of the hosts below. (The last host is likely to have the most up- to-date distributions.) ____________________|___________________________________ ftp.uu.net | /published/oreilly/nutshell/imake ftp.ora.com | /pub/nutshell/imake ftp.primate.wisc.edu| /pub/imake-book ____________________|___________________________________ A sample session is shown, with what you should type in boldface: % ftp ftp.uu.net Connected to ftp.uu.net. 220 FTP server (Version 6.21 Tue Mar 10 22:09:55 EST 1992) ready. Name (ftp.uu.net:kismet): anonymous 331 Guest login OK, send domain style e-mail address as password. Password: kismet@ora.com (Use your user name and host here) 230 Guest login OK, access restrictions apply. ftp> cd /published/oreilly/nutshell/imake 250 CWD command successful. ftp> binary (Very important! You must specify binary transfer for compressed files.) 200 Type set to I. ftp> get imake.tar.Z 200 PORT command successful. 150 Opening BINARY mode data connection for imake.tar.Z. - Copyright c 1993 O'Reilly & Associates. All rights reserved. - A-2 Software Portability with imake (printed 10 August 1993) 226 Transfer complete. ftp> quit 221 Goodbye. % Once you obtain a distribution, extract the files from it by typing: % zcat imake.tar.Z | tar xf - System V systems require the following tar command instead: % zcat imake.tar.Z | tar xof - If zcat is not available on your system, use separate uncompress and tar commands: % uncompress imake.tar.Z % tar xf imake.tar.Z (or tar xof imake.tar.Z) GOPHER To retrieve the software using GOPHER, connect to gopher.primate.wisc.edu, selecting ``Primate Center Software Archives'' from the main menu, then selecting the ``imake- book'' item, and then select the distribution you want. GOPHER clients vary considerably; consult your local docu- mentation for specific instructions. Once you've got the desired distribution, extract the files from it by following the directions under FTP. FTPMAIL FTPMAIL is a mail server available to anyone who can send and receive electronic mail to and from Internet sites. This includes most workstations that have an e-mail connec- tion to the outside world, and CompuServe users. You do not need to be directly on the Internet. Here's how to do it. You send mail to ftpmail@decwrl.dec.com. In the message body, give the name of the anonymous FTP host and the FTP commands you want to run. The server will run anonymous FTP for you and mail the files back to you. To get a complete help file, send a message with no subject and the single word "help" in the body. The following is an example mail session that should get you a listing of the files in the selected directory and the file imake.tar.Z. The listing is useful in case there are other files you may be interested in. % mail ftpmail@decwrl.dec.com Subject: reply alan@ora.com (where you want files mailed) connect ftp.uu.net cd /published/oreilly/nutshell/imake dir binary uuencode (or btoa if you have it) - Copyright c 1993 O'Reilly & Associates. All rights reserved. - Obtaining Configuration Software A-3 get imake.tar.Z quit % A signature at the end of the message is acceptable as long as it appears after "quit." All retrieved files will be split into 60KB chunks and mailed to you. You then remove the mail headers and con- catenate them into one file, and then uudecode or atob it. Once you've got the desired distribution, extract the files from it by following the directions under FTP. BITFTP BITFTP is a mail server for BITNET users. You send it elec- tronic mail messages requesting files, and it sends you back the files by electronic mail. BITFTP currently serves only users who send it mail from nodes that are directly on BIT- NET, EARN, or NetNorth. BITFTP is a public service of Princeton University. Here's how it works. To use BITFTP, send mail containing your FTP commands to BITFTP@PUCC. For a complete help file, send HELP as the message body. The following is the message body you should send to BITFTP: FTP ftp.uu.net NETDATA USER anonymous PASS your Internet e-mail address (not your bitnet address) CD /published/oreilly/nutshell/imake DIR BINARY GET imake.tar.Z QUIT Once you've got the desired distribution, extract the files from it by following the directions under FTP. Questions about BITFTP can be directed to MAINT@PUCC on BIT- NET. UUCP UUCP is standard on virtually all UNIX systems. The software is available by UUCP via modem from UUNET; UUNET's connect-time charges apply. You can get the software from UUNET whether you have an account or not. If you or your company has an account with UUNET, you will have a system with a direct UUCP connection to UUNET. Find that system, and type the following command (type everything on one line): uucp uunet\!~/published/oreilly/nutshell/imake/imake.tar.Z yourhost\!~/yourname/ The backslashes can be omitted if you use the Bourne shell (sh) instead of csh. The file should appear some time later - Copyright c 1993 O'Reilly & Associates. All rights reserved. - A-4 Software Portability with imake (printed 10 August 1993) (up to a day or more) in the directory /usr/spool/uucppublic/yourname. If you don't have an account but would like one so that you can get electronic mail, then contact UUNET at 703-204-8000. If you don't have a UUNET account, you can set up a UUCP connection to UUNET using the phone number 1-900-468-7727. As of this writing, the cost is 50 cents per minute. The charges will appear on your next telephone bill. The login name is "uucp" with no password. For example, an L.sys/Systems entry might look like: uunet Any ACU 19200 1-900-468-7727 ogin:--ogin: uucp Your entry may vary depending on your UUCP configuration. If you have a PEP-capable modem, make sure s50=255s111=30 is set before calling. Try to get the file /published/oreilly/nutshell/imake/ls- lR.Z as a short test file containing the filenames and sizes of all the files in the directory. Once you've got the desired distribution, extract the files from it by following the directions under FTP. - Copyright c 1993 O'Reilly & Associates. All rights reserved. - Obtaining Configuration Software A-5