home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / kernex32.zip / mwdd_src.zip / 32bits / ext2-os2 / doc / mwdd32 / READ.ME < prev    next >
INI File  |  1997-03-16  |  6KB  |  133 lines
  1. [$Header: d:\\32bits\\ext2-os2\\doc\\mwdd32\\rcs\\READ.ME,v 1.8 1997/03/15 17:13:14 Willm Exp $]
  2. ╔═══════════════════════════════════════════════════════════════════════╗
  3. ║  32 bits OS/2 device driver and IFS support. Provides 32 bits kernel  ║
  4. ║  services (DevHelp) and utility functions to 32 bits OS/2 ring 0 code ║
  5. ║  (device drivers and installable file system drivers).                ║
  6. ║  Copyright (C) 1995, 1996, 1997  Matthieu WILLM                       ║
  7. ║                                                                       ║
  8. ║  This program is free software; you can redistribute it and/or modify ║
  9. ║  it under the terms of the GNU General Public License as published by ║
  10. ║  the Free Software Foundation; either version 2 of the License, or    ║
  11. ║  (at your option) any later version.                                  ║
  12. ║                                                                       ║
  13. ║  This program is distributed in the hope that it will be useful,      ║
  14. ║  but WITHOUT ANY WARRANTY; without even the implied warranty of       ║
  15. ║  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        ║
  16. ║  GNU General Public License for more details.                         ║
  17. ║                                                                       ║
  18. ║  You should have received a copy of the GNU General Public License    ║
  19. ║  along with this program; if not, write to the Free Software          ║
  20. ║  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.            ║
  21. ╚═══════════════════════════════════════════════════════════════════════╝
  22.  
  23.                    MWDD32 VERSION 1.70
  24.  
  25.  
  26. WHAT IS MWDD32  ?
  27. -----------------
  28.  
  29.     mwdd32 is a package that allows the implementation of 32 bits OS/2 device drivers
  30. (BASEDEV and DEVICE) as well as 32 bits Installable File Systems (IFS). It is composed
  31. of several parts :
  32.     - a base device driver (mwdd32.sys) that provides kernel services (DevHelp)
  33.       and utility functions callable from 32 bits ring 0 code.
  34.     - a static library (fsh32.lib) that provides thunks from 16 bits IFS entry points
  35.       to 32 bits, and 32 bits interfaces to FSHelper functions. 
  36.     - a sample 32 bits BASEDEV base device driver skeleton, with sources.
  37.     - a sample 32 bits DEVICE device driver skeleton, with sources.
  38.     - a sample 32 bits IFS (Installable File System) driver skeleton, with sources.
  39.     - a sample 32 bits OS/2 SES (Security Enabling Services) base device driver skeleton, 
  40.       with sources.
  41.  
  42.     I created mwdd32 because I started to port my Linux ext2fs IFS to 32 bits
  43. some times ago, and to do this I had to write 32 bits devhelp interfaces (thunks) and other 
  44. routines. I thought it would be useful to make other clients than my IFS profit from
  45. this work. That's why I isolated them in a separate driver and created MWDD32.SYS.
  46.  
  47.     The 32 bits version of my Linux ext2fs IFS is now available and is a good example of
  48. a full featured 32 bits IFS, which uses mwdd32.sys services. It can be found at :
  49. ftp://ftp-os2.nmsu.edu/os2/diskutil/ext2_240.zip
  50. ftp://sunsite.unc.edu/pub/Linux/system/Filesystems/ext2/ext2_240.zip
  51.  
  52.     mwdd32 is still work in progress : not all DevHelp are implemented, but only those
  53. I needed to port ext2-os2 to 32 bits. Suggestions and contributions are welcome
  54. to help me enhance mwdd32.
  55.  
  56. COPYRIGHT NOTICE :
  57. ------------------
  58.  
  59. This package is licensed under terms of the the GNU General Public License. 
  60. See the file COPYING for details.
  61.  
  62. If you want to use my own parts (parts that do not contain code from others)
  63. but not under the GNU General Public License you must contact me and sign an
  64. agreement with me.
  65.  
  66. CREDITS :
  67. ---------
  68.  
  69. Thanks to Holger Veit for the DevHelp calls he added to mwdd32.
  70. Thanks to Sander van Leeuwen for his Watcom 32 bits PDD sample.
  71.  
  72. WARNING :
  73. ---------
  74.  
  75. - MWDD32 IS ONLY USEFUL TO DEVICE DRIVER WRITERS. IT IS *TOTALLY USELESS* FOR 
  76.   NORMAL USERS. DON'T INSTALL IT IF YOU DON'T PLAN TO WRITE DEVICE DRIVERS !!!
  77. - FOR THE MOMENT MWDD32 IS EXPERIMENTAL WORK, STILL IN PROGRESS. PROGRAMMING 
  78.   INTERFACES ARE SUBJECT TO CHANGE. MWDD32.SYS IS PROBABLY STILL UNSTABLE.
  79.  
  80. SUPPORTED OS/2 VERSIONS :
  81. -------------------------
  82.  
  83. - OS/2 WARP V4
  84. - OS/2 WARP V3 with fixpack 17 or higher
  85. - OS/2 WARP V3 without any fixpack applied (except for the sample SES driver)
  86.  
  87. REQUIREMENTS :
  88. --------------
  89.  
  90. - IBM VisualAge C++ 3.0 with at least CSD CTC305, the IBM Devcon DDK V2, as well
  91.   as IBM ALP 4.00.001 are needed to write 32 bits drivers using this package.
  92. - A file system supporting long file names (eg HPFS for instance) is required.
  93.  
  94. Note:
  95.  - The DDK and ALP are now free and can be found at the IBM Online DDK URL :
  96.    http://service.software.ibm.com/ddk
  97.  - IBM Visualage C++ P/N is 5622-679 (it is not free !)
  98.  
  99. INSTALLATION AND USAGE INSTRUCTIONS :
  100. ------------------------------------
  101.  
  102.   Installing mwdd32.sys :
  103.      Simply copy it into \os2\boot on your boot drive, and add the following line in
  104.      your CONFIG.SYS :
  105.     BASEDEV=MWDD32.SYS
  106.  
  107.      NOTE : mwdd32.sys is REQUIRED to make all sample drivers work. It must be loaded 
  108.             before any drivers that use it.
  109.  
  110.   Sample drivers sources and binaries are located in the file mwdd_src.zip.
  111.   The programming documentation is in the mwdd32.inf online help file.
  112.  
  113.  
  114. WHERE TO FIND MWDD32 :
  115. ----------------------
  116.  
  117. ftp://ftp-os2.nmsu.edu/os2/dev32/32drv170.zip
  118. ftp://ftp.leo.org/os2/drivers/source/32drv170.zip
  119. ftp://ftp-os2.cdrom.com/pub/os2/dev32/32drv170.zip
  120.  
  121. DISCLAIMER :
  122. ------------
  123.  
  124. The fact that I work for IBM has nothing to do with this package : this is
  125. spare time work. It is ***NOT*** official IBM support for 32 bits OS/2 
  126. physical device drivers or IFS.
  127.  
  128.  
  129. Matthieu WILLM
  130. willm@ibm.net          (home)
  131.  
  132.  
  133.