AppleShare PC Developers Guide

l( ti® Apple® AppleShare@ PC Developer's Guide Apple Confidential Final Draft 7/15/88 I t ti APPLE COMPUTER, INC. This manual is copyrighted, with all rights reserved. Under the copyright laws, this manual may not be copied, in whole or part, without written consent of Apple. Under the law, copying includes translating into another language or format. ©Apple Computer, Inc., 1988 20525 Mariani Ave. Cupertino, California 95014 USA 1-(408) 996-1010 Apple, the Apple logo, AppleTalk, ImageWriter, LaserWriter, and Macintosh are registered trademarks of Apple Computer, Inc. AppleShare, A/UX, and LocalTalk are trademarks of Apple Computer, Inc. Microsoft and MS-DOS are registered trademarks of Microsoft Corporation. IBM is a registered trademark of IBM Corporation. Postscript is a registered trademark of Adobe Systems Incorporated. Lotus and 1-2-3 are registered trademarks of Lotus Development Corporation. Epson is a registered trademark of Seiko Epson Corporation. AppleShare PC developer's guide - Apple Confidential Final draft • Contents Figures and tables xii Pref ace What you need to know ix Related documents x Organization xi Chapter 1 AppleShare PC Overview Requirements 3 Chapter 2 Access Privileges 5 How access privileges work 6 How privilege violations appear to DOS programs 7 How to work with access privileges 8 Chapter 3 Network Awareness & Multi-User Considerations 9 Atomicity 10 Opening files 11 Sharing modes 11 Compatibility mode 12 Overlays 13 Byte range locking 14 Temporary files 14 Open file categories 15 iii AppleShare PC developer's guide - Apple Ccntldentlal Final draft • lv Contents Chapter 4 Directory Enumeration 17 Alphabetically ordered directories 18 Enumeration guidelines 19 Enumeration lifetime 19 Reappearing directory entries 20 Backing up 22 Chapter 5 DOS Enhancements 23 Large volumes 24 Moving directories 24 Enhanced file and directory information 25 Lowercase names 25 Modified bit 26 Checking access privileges 26 Chapter 6 Integration with Macintosh Applications 29 Common file formats 30 ASCII text 30 File extension mapping 33 Adding mappings 34 Saving files 35 Chapter 7 Print Access 37 BIOS-level support 38 DOS-level support 40 Printer calls 41 Printer critical errors 41 Epson mode 41 PostScript mode 42 AppleShare PC developer's guide - Apple Confidential Final draft Appendix A Programming Examples 43 Standard start-up sequence 43 DOS version check 43 Checking for SHARE 44 Checking for AppleShare PC 45 Installing a critical error handler 47 Character handling 49 End-of-line delimiters 49 International uppercase routine 51 Multi-User I/0 53 Extending a file 53 File extension mapping 55 Appendix B Network and Mulfl·User Errors 57 Contents v AppleShare PC developar's guide - Apple Confldentlal Flnal draft • vi Contents AppleShare PC developer's guide - Apple Confldentlal Final draft "( Figures and tables Chapter 1 AppleShare PC Overview 2 Figure 1-1 Chapter 3 Network Aw…