ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º ÚÄÄÄ¿ JIM TUCKER þ SOFTWARE º º ÚÄÁÄ¿ ÃÄÄ¿ 4/635 Brighton Road, Seacliff º º ³ ÚÁÄÁ¿ ³ South Australia, AUSTRALIA 5049 º º ÀÄÄ´ ÃÄÙ Email: jtucker@byron.apana.org.au º º ÀÄÄÄÙ º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ NETRUN Release 3.1 June 1995. Copyright 1995 by JIM TUCKER NETRUN is free for personal use only. You may distribute NETRUN provided you do not charge for it. Use of NETRUN for commercial purposes is expressly prohibited. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ABOUT NETRUN ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ NETRUN provides a convenient way to send DOS programs by e-mail. NETRUN converts programs to text similar to UUEncoding, however the text is an executable program. This simply means the recipient does not have to decode the program to run it. Usage: NETRUN [-options] [OUTFILE] If your do not specify a target file NETRUN will use the source filename with the extension .NTR. You may specify paths. For a quick demo use NETRUN to encode itself. Enter NETRUN NETRUN.COM then look at the file NETRUN.NTR with a text editor. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ NETRUN OPTIONS ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Both "-" and "/" are valid switch characters. Options may be caps or lower case. Enter NETRUN for a short summary. NONE With no option NETRUN will create an executable ASCII file. The source file must be a program (either COM or EXE). The target file will include user instructions. -Z No instructions at the start and end of the target file. NETRUN -Z INFILE.COM OUTFILE.COM will create an executable file that does not need editing. -S Write short instructions only (filename and clip line) at the start of the file. -$FILENAME | NETRUN will use your file as instructions at the top of the file. The maximum file size is 32,000 bytes. -U UUEncode. NETRUN contains a UUEncoder for large files. If you specify a target filename it will be used otherwise NETRUN append .UUE to the source filename. Usage: NETRUN -U FILENAME -M I've made life easy. -M creates a mini UUdecoder MUUD.COM. Simply run MUUD through NETRUN and email it with UUEncoded files. Usage: NETRUN -M (then) NETRUN MUUD.COM -D Creates NETRUN.DOC (this document). The documentation is included in the program so you can convert NETRUN.COM into a NETRUN file and e-mail it in a single package. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ NOTES ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ NETRUN will not encode a file larger than 51,000 bytes. If your source file is larger NETRUN will ask you if you want to UUEncode it instead. (You may create and NETRUN the decoder. See the -M option). Programs will be smaller if you use PKLITE or LZEXE to compress them. Both are available at ftp and BBS sites. COM programs in NETRUN format execute from memory. EXE files are written to disk with a temporary filename and executed by DOS. NETRUN will detect if a file is COM or EXE from the contents, not the filename extension. You cannot encode data files (see below for information about NETSEND). A NETRUN program is pure ASCII. It is impossible for a virus to infect a NETRUN file without being visible, although not impossible for an encoded file to contain a bad program. NETRUN uses Base 91 coding. Generally files will be much smaller than those UUEncoded. NETRUN files may use DOS, UNIX or Mac end of line codes. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ TROUBLE SHOOTING ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Please check that your NETRUN program executes correctly before mailing it. If not check the following: o It was clipped using a **TEXT** editor. Enter TYPE FILENAME at the DOS prompt. This should display the file as normal text. o The program must begin with the line starting XPPPYZ... Normally text may be left at the end of the program. However it will not load if the file exceeds approximately 65,300 bytes. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ABOUT THE AUTHOR - JIM TUCKER ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ I live in Seacliff, a seaside suburb of Adelaide, South Australia (down the bottom facing Antarctica). If you use NETRUN send mail. I would appreciate a newspaper from your town. My thanks to Keith Levkoff, William Luitje and Terje Mathisen for their suggestions. Two similar programs: o NETSEND is a program similar to NETRUN except when the ASCII program is executed the source file is extracted. NETSEND includes file compression and will handle files larger than 52,000 bytes if they have not already been compressed. o NETPIC allows you to convert any size GIF picture to 320x200x256 color in an ASCII format similar to NETRUN. The pictures need no decoding and no viewer! The ASCII text displays the picture. They may be dowloaded via anonymous ftp from SimTel mirror sites. I have not specified the version number (*) as this changes. The file netpic*.zip includes several sample GIF files. ftp://ftp.coast.net/SimTel/msdos/decode/netsend*.zip ~10K ftp://ftp.coast.net/SimTel/msdos/decode/netrun*.zip ~10K ftp://ftp.coast.net/SimTel/msdos/graphics/netpic*.zip ~190K I maintain a local anonymous ftp site for software. It contains the latest versions, applications (some with source code) as well as shareware programs mentioned in documentation: ftp://kludge.byron.apana.org.au/pub/jtsoftware/FILES.TXT JIM TUCKER jtucker@byron.apana.org.au END