home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ext2_240.zip / README < prev    next >
INI File  |  1997-08-06  |  9KB  |  179 lines
  1. [$Header: d:\\32bits\\ext2-os2\\doc\\ext2-os2\\rcs\\README,v 1.7 1997/03/15 17:06:48 Willm Exp $]
  2. ╔═══════════════════════════════════════════════════════════════════════╗
  3. ║  32 bits Linux ext2 file system driver for OS/2 WARP - Allows OS/2 to ║
  4. ║  access your Linux ext2fs partitions as normal drive letters.         ║
  5. ║  Copyright (C) 1995, 1996, 1997  Matthieu WILLM (willm@ibm.net)       ║
  6. ║                                                                       ║
  7. ║  This program is free software; you can redistribute it and/or modify ║
  8. ║  it under the terms of the GNU General Public License as published by ║
  9. ║  the Free Software Foundation; either version 2 of the License, or    ║
  10. ║  (at your option) any later version.                                  ║
  11. ║                                                                       ║
  12. ║  This program is distributed in the hope that it will be useful,      ║
  13. ║  but WITHOUT ANY WARRANTY; without even the implied warranty of       ║
  14. ║  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        ║
  15. ║  GNU General Public License for more details.                         ║
  16. ║                                                                       ║
  17. ║  You should have received a copy of the GNU General Public License    ║
  18. ║  along with this program; if not, write to the Free Software          ║
  19. ║  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.            ║
  20. ╚═══════════════════════════════════════════════════════════════════════╝
  21.  
  22.               EXT2-OS2 VERSION 2.40 (32 BITS EDITION)
  23.  
  24.  
  25. WHAT IS EXT2-OS2  ?
  26. -------------------
  27.  
  28. ext2-os2.ifs is a file system driver that allows OS/2 to seamlessly access
  29. Linux native partitions (ext2fs partitions) in both read and write modes.
  30. Once installed, Linux partitions appear as standard OS/2 drive letters, one
  31. per Linux partition. It is a port of the original Linux ext2fs kernel code.
  32.  
  33. ext2-os2 can even be used without Linux, as it can format or check ext2 file
  34. systems directly from OS/2. This can be useful for people who need huge cache
  35. sizes, for large compilations for instance ; it can also be useful for people
  36. wanting long file names on removable media.
  37.  
  38. INSTALLATION AND USAGE INSTRUCTIONS :
  39. ------------------------------------
  40.  
  41. Please consult the online help file (ext2-os2.inf) for
  42. IMPORTANT installation and configuration instructions.
  43. Please read the documentation BEFORE installing the driver !!
  44.  
  45. A HTML version of the documentation is also available (ext2-os2.htm)
  46. This HTML version has been produced from the IPF version with IBM
  47. Hyperwise. It can be viewed with any good web browser, such as the
  48. WebExplorer included in the OS/2 Bonus Pack.
  49.  
  50. ***********************************************
  51. ***** IMPORTANT WARNING - READ THIS FIRST *****
  52. ***********************************************
  53.  
  54. ext2-os2 is a FILE SYSTEM DRIVER. Being a driver it runs at the most
  55. privileged level of the OS/2 operating system, known as "kernel mode".  
  56. IN KERNEL MODE THERE IS NO MORE CRASH PROTECTION.  It means that if a bug 
  57. occurs in the driver IT CAN CAUSE A HANG OR A SYSTEM HALT, AND THUS CAN 
  58. CAUSE LOSS OF DATA.
  59.  
  60.  - I STRONGLY SUGGEST YOU TO MAKE A BACKUP OF ALL YOUR DATA (EVEN IF THEY 
  61.    ARE NOT LOCATED ON A LINUX PARTITION) PRIOR TO USE THIS DRIVER.
  62.  
  63.  - DON'T USE THIS DRIVER ON A PRODUCTION MACHINE, OR IF YOU MANIPULATE
  64.    CRITICAL DATA.
  65.  
  66.  - IF HUMAN LIFE DEPENDS ON YOUR SYSTEM, DON'T INSTALL THIS DRIVER ON IT.
  67.  
  68.  - USE IT AT YOUR OWN RISKS, AND ONLY ON A MACHINE YOU ACCEPT TO CRASH
  69.    AND REINSTALL.
  70.  
  71.  - BE AWARE THAT THIS DRIVER WILL GIVE FULL UNRESTRICTED (ROOT) ACCESS TO 
  72.    ALL YOUR EXT2FS PARTITIONS FROM OS/2.
  73.  
  74. Now experience tends to prove that ext2-os2 is stable for normal use...
  75. but doing regular backups is never a bad practice.
  76.  
  77. MAIN CHANGES SINCE PREVIOUS RELEASE :
  78. -------------------------------------
  79. - bug fixes
  80. - performance improvements
  81. - removed the 2 Gb limit previously present in e2fsck, mke2fs and badblocks.
  82.  
  83. INCLUDED IN THIS PACKAGE :
  84. --------------------------
  85.  
  86. The package includes Deon van der Westhuysen's Linux partition filter V 1.2c
  87. This filter driver will allow you to make you Linux partitions visible to OS/2 
  88. without altering the partition table, so that ext2-os2.ifs can mount them.
  89. This driver can also reorder hard drive letters assigned by OS/2 ; this can solve
  90. many partition headaches when having more than one operating system on a machine.
  91. Please look at the file ext2flt.doc and ext2-os2.inf for its usage and Deon's 
  92. copyright notice. 
  93.  
  94. DEFAULTS SETTINGS :
  95. -------------------
  96.  - The default behavior after installation is read only. To turn on read/write
  97.    access you have to specify -rw on the ext2-os2.ifs command line AND /W
  98.    on the ext2flt.flt command line.
  99.  - By default, ext2-os2 is case sensitive. It MUST be changed to case retensive if
  100.    you plan to run programs from a Linux partition. See the online help file for
  101.    details (-case_retensive option). 
  102.  
  103. FEATURES AND RESTRICTIONS OF THE 32 BITS VERSION OF EXT2-OS2 :
  104. --------------------------------------------------------------
  105.  
  106.   OS/2 Requirements :
  107.       - OS/2 WARP V4 : supported.
  108.       - OS/2 WARP V3 : fixpack 17 or higher is required. Bare OS/2 
  109.                        WARP (no fixpack) should be OK but I did not
  110.                        test it.
  111.       - OS/2 2.x  : not supported.
  112.       - OS/2 1.x  : not supported.
  113.  
  114.   Benefits of the 32 bits version :
  115.       - Now it can be compiled with a modern compiler (IBM Visualage C++)
  116.         Old MS junks are no longer necessary (at least for ext2-os2.ifs)
  117.       - Larger cache sizes can be used than with the 16 bits version. 
  118.         (system limits are a lot higher).
  119.       - In some area, a significant performance gain can be observed
  120.         (eg 25% on a 16 Mb file write).
  121.  
  122.   How does it work ?
  123.       OS/2 still has a 16 bits Physical Device Driver model, as well
  124.       as a 16 bits IFS model. An IFS is actually a library with a
  125.       predefined set of entry points to perform file I/O operations.
  126.       These entry points are 16 bits protect mode. The first thing each
  127.       entry point does is to load 32 bits FLAT segment registers and jump 
  128.       to the 32 bits routine performing the actual operation. Before doing
  129.       the actual job, 16 bits pointers passed to the routine are converted
  130.       to 32 bits pointers using a kernel helper. This process is known as
  131.       "thunking". In OS/2 kernel mode, this thunking is fast and efficient
  132.       since stack switching is not required (the stack segment register 
  133.       is not reloaded). 
  134.           At some point, the IFS may need to call the kernel for some 
  135.       services. Here again, as the kernel services are 16 bits entry points
  136.       (Device Helpers, File System Helpers), this thunking process is 
  137.       necessary. To do this I wrote an interface to Device Helpers callable
  138.       from 32 bits Visualage C++ code. Since this interface is generic and
  139.       independant from ext2-os2.ifs, I isolated it in a separate driver
  140.       (mwdd32.sys) so that other clients than ext2-os2.ifs can use it.
  141.  
  142.   Installation notice :
  143.       a new component (mwdd32.sys) is necessary to make ext2-os2.ifs work.
  144.       Don't remove mwdd32.sys from CONFIG.SYS !!
  145.  
  146.   Developping other 32 bits IFS or device drivers :
  147.       Other device drivers and IFS can profit from the facilities I had to
  148.       implement to port ext2-os2 to 32 bits. The package includes the file
  149.       32drv170.zip, which contains mwdd32.sys sources, as well as skeletons
  150.       of a 32 bits BASEDEV and a 32 bits IFS.
  151.  
  152. WHERE TO FIND EXT2-OS2 :
  153. ------------------------
  154.  
  155. You can find the latest version of ext2-os2 at the ext2-os2 home page :
  156.  
  157.     http://www.geocities.com/SiliconValley/Bay/5313
  158.  
  159. You can also find it at the usual ftp sites (or in their incoming directory) :
  160.  
  161.     ftp://ftp-os2.nmsu.edu/pub/os2/system/drivers/filesys/ext2_240.zip
  162.     ftp://sunsite.unc.edu/pub/Linux/system/Filesystems/ext2/ext2_240.zip
  163.     ftp://ftp.leo.org/pub/comp/os/os2/drivers/ifs/ext2_240.zip
  164.     ftp://ftp-os2.cdrom.com/pub/os2/diskutil/ext2_240.zip
  165.  
  166.  
  167. FEEDBACK AND SUPPORT :
  168. ----------------------
  169.  
  170. Please feel free to contact me for any question on ext2-os2. You are also encouraged
  171. to give me some feedback on how it works on your system and what new features you would
  172. like ... this helps me improve it ! Both success stories and disasters interest me.
  173.  
  174.  
  175.  
  176. Matthieu WILLM
  177. willm@ibm.net
  178.  
  179.