You can obtain the source code for the programs presented in this book from O'Reilly & Associates through their Internet server. The example programs in this book are available electronically in a number of ways: by FTP, Ftpmail, BITFTP, and UUCP. The cheapest, fastest, and easiest ways are listed first. If you read from the top down, the first one that works for you is probably the best. Use FTP 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 can send electronic mail via BITNET. Use UUCP if none of the above works.
ftp ftp.oreilly.comConnected to ftp.oreilly.com. 220 FTP server (Version 6.21 Tue Mar 10 22:09:55 EST 1992) ready. Name (ftp.oreilly.com:yourname):
anonymous331 Guest login ok, send domain style e-mail address as password. Password:
firstname.lastname@example.org(Use your user name and host here) 230 Guest login ok, access restrictions apply. ftp>
cd /published/oreilly/nutshell/sedawk_2250 CWD command successful. ftp>
binary(Very important! You must specify binary transfer for compressed files.) 200 Type set to I. ftp>
get progs.tar.gz200 PORT command successful. 150 Opening BINARY mode data connection for progs.tar.gz. 226 Transfer complete. ftp>
The file is a gzip compressed tar archive; extract the files from the archive by typing:
gzcat progs.tar.gz | tar xvf -
System V systems require the following tar command instead:
gzcat progs.tar.gz | tar xof -
If gzcat is not available on your system, use separate gunzip and tar commands.
tar xvf progs.tar
Ftpmail is a mail server available to anyone who can send electronic mail to and receive it from Internet sites. This includes any company or service provider that allows email connections to the Internet. Here's how you do it. You send mail to email@example.com. In the message body, give 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 a sample mail session that should get you the examples. This command sends you a listing of the files in the selected directory and the requested example files. The listing is useful if there's a later version of the examples you're interested in.
firstname.lastname@example.org(Where you want files mailed) open cd /published/oreilly/nutshell/sedawk_2 dir mode binary uuencode get progs.tar.gz quit .
A signature at the end of the message is acceptable as long as it appears after "quit."
BITFTP is a mail server for BITNET users. You send it electronic mail
messages requesting files, and it sends you back the files by electronic mail.
serves only users who send it mail from nodes that are directly on
BITNET, EARN, or NetNorth. 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 send to BITFTP:
FTP ftp.oreilly.com NETDATA USER anonymous PASS email@example.com Put your Internet email address here (not your BITNET address) CD /published/oreilly/nutshell/sedawk_2 DIR BINARY GET progs.tar.gz QUIT
Once you've got the desired file, follow the directions under FTP to extract the files from the archive. Since you are probably not on a UNIX system, you may need to get versions of uudecode, gunzip, atob, and tar for your system. VMS, DOS, and Mac versions are available.
UUCP is standard on virtually all UNIX systems and is available for IBM-compatible PCs and Apple Macintoshes. The examples are available by UUCP via modem from UUNET; UUNET's connect-time charges apply. If you or your company has an account with UUNET, you have a system somewhere with a direct UUCP connection to UUNET. Find that system, and type:
uucp uunet\!~/published/oreilly/nutshell/sedawk_2/progs.tar.gz yourhost\!~/yourname/
The backslashes can be omitted if you use a Bourne-style shell (sh, ksh, bash, zsh, pdksh) instead of csh or tcsh. The file should appear some time later (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, contact UUNET at 703-206-5400. It's a good idea to get the file /published/oreilly/ls-lR.Z as a short test file containing the filenames and sizes of all the files available. Once you've got the desired file, follow the directions under FTP to extract the files from the archive.