home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / win95 / ext2tool.exe / README < prev   
Text File  |  1996-01-09  |  7KB  |  248 lines
  1. EXT2 TOOLS
  2. ==========
  3.  
  4. Version 1.1 - 9 January 1996
  5.  
  6.  
  7. CHANGES SINCE VERSION 1.0
  8. -------------------------
  9.  
  10. E2LS now supports wildcards.
  11.  
  12. A bug relating to handling disks with more than 2 partitions within
  13. an extended partion has been corrected.
  14.  
  15. The need to customize E2CD for 4DOS has been removed.
  16.  
  17.  
  18. INTRODUCTION
  19. ------------
  20.  
  21. The ext2 tools are a set of programs that enable you to read a Linux
  22. ext2 file system under DOS.
  23.  
  24. The ext2 tools consist of the following programs:
  25.  
  26.    E2CAT     analogous to the Linux cat command
  27.    E2CD      analogous to the Linux cd command
  28.    E2CP      analogous to the Linux cp command
  29.    E2LS      analogous to the Linux ls command
  30.    E2PART    lists hard disk partitions
  31.    E2PWD     analogous to the Linux pwd command
  32.  
  33. All these programs have been compiled with GCC and require the GO32
  34. DOS extender in order to execute.
  35.  
  36. There are currently no programs for writing to an ext2 file system and
  37. probably never will be unless someone else would care to make them.
  38.  
  39. The programs are distributed in both binary and source code form.
  40.  
  41.  
  42. COPYRIGHT
  43. ---------
  44.  
  45. The ext2 tools are copyright (C) 1995 Claus Tondering (ct@login.dknet.dk).
  46.  
  47. Note: The ext2fs routines are copyright (C) 1993, 1994 Theodore Ts'o.
  48. For further copyrights, see the source code files.
  49.  
  50. The ext2 tools may be redistributed under the terms of the GNU General
  51. Public License, which is included in the file called COPYING.
  52.  
  53. For your convenience the GO32 program has been included in this
  54. distribution. It is part of the DJGPP distribution, which can be obtained
  55. by anonymous FTP from oak.oakland.edu in the directory /SimTel/vendors/djgpp.
  56.  
  57.  
  58. DISCLAIMER
  59. ----------
  60.  
  61. This is free software. Use it at your own risk. If it doesn't work,
  62. it's your problem, not mine.
  63.  
  64.  
  65.  
  66. BASIC PRINCIPLES
  67. ----------------
  68.  
  69. Before you use the ext2 tools, you must set the environment variable
  70. E2CWD using a statement similar to the following:
  71.  
  72.     SET E2CWD=129:5
  73. or
  74.     SET E2CWD=129:5:234
  75.  
  76. The three numbers after the equals sign are interpreted thus:
  77.  
  78. The first number (129 in the above example) identifies the physical
  79. disk on which the ext2 file system is located. The number is used as
  80. the second parameter to the DOS biosdisk() routine (BIOS interrupt
  81. 0x13). Typical values are:
  82.       0 for A: disk
  83.       1 for B: disk
  84.     128 for first hard disk
  85.     129 for second hard disk
  86.  
  87. (See the 'BUGS' section at the end of this document for information
  88. about using a third hard disk.)
  89.  
  90. The second number (5 in the above example) is the number of the disk
  91. partition on which the ext2 file system is located. This number is
  92. typically part of the Linux file name for the disk device.  If, for
  93. example, you are used to referring to the disk as /dev/hdb5 under
  94. Linux, the partition number is 5. The E2PART program can help you
  95. identify the partitions.
  96.  
  97. The third number is the inode number of the directory that is to be
  98. your current working directory. If this number is omitted, 2 (the root
  99. inode number) is used. If you don't know what an inode is, don't worry.
  100. Just omit the final number from E2CWD.
  101.  
  102. Note: File names starting with / will be interpreted relative to the
  103. root directory on the particular disk identified by the E2CWD
  104. environment variable.
  105.  
  106. Only E2LS supports wildcards.
  107.  
  108. Be sure to have the GO32.EXE program somewhere in your PATH.
  109.  
  110.  
  111.  
  112. E2CAT
  113. -----
  114.  
  115. SYNOPSIS
  116.     E2CAT [-bt] pathname
  117.  
  118. DESCTIPTION
  119.     The E2CAT program will copy the contents of the file identified
  120.     by ext2 pathname to the standard output.
  121.  
  122.     The following options are available:
  123.  
  124.     -b    Binary mode. No translation performed.
  125.     
  126.     -t    Text mode (default). LF translated to CR/LF.
  127.  
  128.  
  129.  
  130. E2CD
  131. ----
  132.  
  133. SYNOPSIS
  134.     E2CD pathname
  135.  
  136. DESCRIPTION
  137.     The pathname must identify an ext2 directory. That directory is
  138.     made the current working directory.
  139.  
  140. NOTE
  141.     E2CD is a .BAT file that creates another .BAT file (called
  142.     ___E2CD.BAT) that modifies the E2CWD environment variable. It
  143.     then executes ___E2CD.BAT and deletes it. (So beware if you
  144.     already have a file called ___E2CD.BAT.)
  145.  
  146.     For use with 4DOS, an E2CD.BTM file is also included. 4DOS
  147.     will use that instead of E2CD.BAT.    
  148.  
  149.  
  150. E2CP
  151. ----
  152.  
  153. SYNOPSIS
  154.     E2CP [-bt] file1 file2
  155.  
  156. DESCTIPTION
  157.     The E2CP program will copy the contents of the file identified
  158.     by ext2 pathname 'file1' to the MSDOS file 'file2'.
  159.  
  160.     The following options are available:
  161.  
  162.     -b    Binary mode (default). No translation performed.
  163.     
  164.     -t    Text mode. LF translated to CR/LF.
  165.  
  166.  
  167.  
  168. E2LS
  169. ----
  170.  
  171. SYNOPSIS
  172.     E2LS [-adiltr] pathname ...
  173.  
  174. DESCRIPTION
  175.     The pathnames may identify ext2 directories or files. Wildcard
  176.     characters (*, [], ?, etc.) may be used in a manner similar to
  177.     what the Linux shell allows.
  178.  
  179.     The E2LS program provides a directory listing of the specified
  180.     pathnames in a manner similar to the Linux ls program.
  181.  
  182.     The following options are supported:
  183.  
  184.     -a    Include file names starting with . in listing.
  185.     -d    List only pathname, even if it is a directory.
  186.     -i    Include inode number in listing.
  187.     -l    Produce a long listing.
  188.     -t    Sort by modification time.
  189.     -r    Reverse the sort order.
  190.  
  191.  
  192.  
  193.  
  194. E2PART
  195. ------
  196.  
  197. SYNOPSIS
  198.     E2PART diskno
  199.  
  200. DESCRIPTION
  201.     The E2PART program lists the partitions that are available on a
  202.     particular physical disk. This program does not use the E2CWD
  203.     environment variable, instead the disk number is given as an
  204.     argument to the E2PART program.
  205.  
  206. BUGS
  207.     The program is not very good at identifying MSDOS file systems.
  208.  
  209.  
  210.  
  211. E2PWD
  212. -----
  213.  
  214. SYNOPSIS
  215.     E2PWD
  216.  
  217. DESCRIPTION
  218.     The E2PWD program prints the current directory.
  219.  
  220.  
  221.  
  222.  
  223. HOW TO CONTACT THE AUTHOR
  224. -------------------------
  225.  
  226. The author can be contacted by e-mail at ct@login.dknet.dk.
  227.  
  228.  
  229.  
  230. BUGS
  231. ----
  232.  
  233. If you have a third hard disk, you may or may not be able to use it
  234. with the ext2 tools. The reason is that there is no standard way to
  235. access a third hard disk through the BIOS. The ext2 tools use BIOS
  236. interrupt 0x13 to access the disks, and the useability of the ext2
  237. tools depends on how your BIOS accesses a third hard disk.
  238.  
  239. If you have an SCSI disk, you may or may not be able to use it with
  240. the ext2 tools. Again, the useability depends on whether your disk is
  241. accessible through BIOS interrupt 0x13.
  242.  
  243. If your disk is too large for the BIOS to handle, you cannot use the
  244. ext2 tools on partitions that extend beyond what the BIOS can handle.
  245.  
  246. The pathnames given as arguments to the programs must not traverse
  247. directories that are symbolic links.
  248.