Part 1Ú@-lÿÿÿþˆ€„&ÿþ@-h‚ËÔ¬Àm @tËÔ2TEXT????,K™`<™`<´HnÿüNºH/+Nª/+,NMACINTOSH KERMIT (Chapter of Kermit User Guide) (Part 1 of 4) 10. MACINTOSH KERMIT Program: Bill Catchings, Bill Schilit, Frank da Cruz, Columbia University. Language: C (SUMACC) Documentation: Frank da Cruz, Bill Schilit Version: 0.8(33) Date: July, 1985 Macintosh Kermit, or "MacKermit", is an implemtation of the Kermit file trans- fer protocol for the Apple Macintosh (and Macintosh-XL) computer, developed at Columbia University, based on C-Kermit (which also forms the nucleus of Unix Kermit). MacKermit Capabilities At A Glance: Local operation: Yes Remote operation: Yes (server mode only) Login scripts: No Transfer text files: Yes Transfer binary files: Yes Wildcard send: No File transfer interruption: Yes Filename collision avoidance: Yes Can time out: Yes 8th-bit prefixing: Yes Repeat count prefixing: Yes Alternate block checks: Yes Terminal emulation: Yes (VT100,VT102) Communication settings: Yes Transmit BREAK: Yes Support for dialout modems: No IBM mainframe communication: Yes Transaction logging: No Session logging: No Debug logging: No Packet logging: No Act as server: Yes Talk to server: Yes Advanced server functions: No Local file management: Yes Command/Init files: Yes File attributes packets: No Command macros: No Raw file transmit: No The main differences between MacKermit and other Kermit programs are: - In MacKermit you are always connected via a terminal emulator (VT102). - MacKermit commands are issued by means of pull-down menus that over- lay your terminal session. The major menus are File, Settings, Remote, and Transfer. The File menu in- vokes Kermit's file transfer functions, allows settings to be saved and res- tored, and like most Macintosh applications, includes a "quit" selection for leaving the program. The Settings menu provides dialog boxes for file, communications, and protocol settings. The Remote menu has the commands that can be sent to Kermit servers, as well as an option to turn Macintosh Kermit itself into a server. The Transfer menu gives you a standard Macintosh file box, allowing you to transfer directly to the selected application. 10.1. The Macintosh File System The Macintosh file system consists of one or more disks, each disk containing files. All files on a disk must have a unique name. Files may be collected together into "folders", but folders are not analogous to directories on other file systems, and no two folders on the same disk may contain files of the same name. Macintosh file names may contain practically any printable characters, including space and punctuation -- but colon (":") should be avoided because it is used in device names. 10.2. File Transfer Glossary: - Mode - Text or Binary. Binary means the data is sent or stored with- out modification. Text means that every carriage return character (CR) in a Macintosh file is translated to a carriage-return-linefeed (CRLF) sequence when sending, and every CRLF in an incoming file is turned into a CR when stored on the Mac disk. A text file is produced when you save a file from MacWrite using the "text only" op- tion; text files are not associated with any particular Macintosh ap- plication and can be sent in a useful fashion to other kinds of com- puters. - Fork - Data or Resource. Macintosh files may have two "forks". The data fork contains data for an application; the resource fork con- tains icons, strings, dialog boxes, and so forth. For instance, a MacWrite document contains text and formatting information in the data fork, and fonts in the resource fork. For applications, the ex- ecutable code is stored in the resource fork. Macintosh Kermit supports the standard Kermit commands for transferring files -- Send, Receive, and Get. Invocation of any of these commands produces a MacKermit file dialog box in which you specify the file name, the mode, and the fork. Defaults are determined from the selected file or taken from the current file settings, described below. When you select the Send command, you get a MacKermit file open box, which in- cludes the standard Macintosh dialog items -- a file list, Disk and Eject but- tons, etc. You can only send one file at a time, by clicking on its name in the file list. Clicking the Disk button will switch the file list to another physical disk. If desired, you can type an alternate name to send the file un- der. When you select a file, MacKermit examines its type; if the type is APPL, then MacKermit expects to send the resource fork in binary mode, otherwise the data fork in text mode. The Mode and Fork radio buttons will display these choices; you may change them before clicking the Send button. You can receive or get multiple files, providing the opposite Kermit is capable of sending multiple files in a single transaction (most are). As files arrive, they will be decoded according to the current mode (text or binary), and stored in the default fork (data or resource) under either the name they arrive with (overwriting existing files of the same names) or under new unique names (when name conflicts occur), according to the current default for name collisions. You may also elect to perform an "attended" receive, in which you have an op- portunity to override all file defaults on a per-file basis. But this option must be used with caution -- if you take too long (more than about a minute) to execute an incoming file's dialog box, the opposite Kermit could time out and terminate the transaction. The folder for new files is the same as the location of the settings file, or if no settings file was used then the new files appear on the desktop. If you are transferring a lot of files and want to keep them together, create a folder, drag the settings file into it, and double click on the settings file; all created files will appear in that folder. File transfers can be cancelled by clicking on the Cancel File or Cancel Group buttons. These will always work when sending. When receiving, they will work if the opposite Kermit honors this (optional) feature of the protocol. In any case, an "emergency exit" from any protocol operation can be taken at any time by typing "Command-." -- that is, hold down the Command (Fan, Cloverleaf) key and type period. an be taken at any time by typing "Command-." -- t