home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd2.bin / dosutils / ext2tool / readme < prev    next >
Text File  |  1995-05-17  |  5KB  |  213 lines
  1. EXT2 TOOLS
  2. ==========
  3.  
  4. Version 1.0 - 17 May 1995
  5.  
  6.  
  7. INTRODUCTION
  8. ------------
  9.  
  10. The ext2 tools are a set of programs that enable you to read a Linux
  11. ext2 file system under DOS.
  12.  
  13. The ext2 tools consist of the following programs:
  14.  
  15.    E2CAT     analogous to the Linux cat command
  16.    E2CD      analogous to the Linux cd command
  17.    E2CP      analogous to the Linux cp command
  18.    E2LS      analogous to the Linux ls command
  19.    E2PART    lists hard disk partitions
  20.    E2PWD     analogous to the Linux pwd command
  21.  
  22. All these programs have been compiled with GCC and require the GO32
  23. DOS extender in order to execute.
  24.  
  25. There are currently no programs for writing to an ext2 file system and
  26. probably never will be unless someone else would care to make them.
  27.  
  28. The programs are distributed in both binary and source code form.
  29.  
  30.  
  31. COPYRIGHT
  32. ---------
  33.  
  34. The ext2 tools are copyright (C) 1995 Claus Tondering (ct@login.dknet.dk).
  35.  
  36. Note: The ext2fs routines are copyright (C) 1993, 1994 Theodore Ts'o.
  37. For further copyrights, see the source code files.
  38.  
  39. The ext2 tools may be redistributed under the terms of the GNU General
  40. Public License, which is included in the file called COPYING.
  41.  
  42. For your convenience the GO32 program has been included in this
  43. distribution. It is part of the DJGPP distribution, which can be obtained
  44. by anonymous FTP from oak.oakland.edu in the directory /SimTel/msdos/djgpp.
  45.  
  46.  
  47. DISCLAIMER
  48. ----------
  49.  
  50. This is free software. Use it at your own risk. If it doesn't work,
  51. it's your problem, not mine.
  52.  
  53.  
  54.  
  55. BASIC PRINCIPLES
  56. ----------------
  57.  
  58. Before you use the ext2 tools, you must set the environment variable
  59. E2CWD using a statement similar to the following:
  60.  
  61.     SET E2CWD=129:5
  62. or
  63.     SET E2CWD=129:5:234
  64.  
  65. The three numbers after the equals sign are interpreted thus:
  66.  
  67. The first number (129 in the above example) identifies the physical
  68. disk on which the ext2 file system is located. The number is used as
  69. the second parameter to the DOS biosdisk() routine. Typical values
  70. are:
  71.       0 for A: disk
  72.       1 for B: disk
  73.     128 for first hard disk
  74.     129 for second hard disk
  75.  
  76. (Your BIOS may use different values, especially if you have an SCSI
  77. drive.)
  78.  
  79. The second number (5 in the above example) is the number of the disk
  80. partition on which the ext2 file system is located. This number is
  81. typically part of the Linux file name for the disk device.  If, for
  82. example, you are used to referring to the disk as /dev/hdb5 under
  83. Linux, the partition number is 5. The E2PART program can help you
  84. identify the partitions.
  85.  
  86. The third number is the inode number of the directory that is to be
  87. your current working directory. If this number is omitted, 2 (the root
  88. inode number) is used. If you don't know what an inode is, don't worry.
  89. Just omit the final number from E2CWD.
  90.  
  91. Note: File names starting with / will be interpretet relative to the
  92. root directory on the particular disk identified by the E2CWD
  93. environment variable.
  94.  
  95. None of the programs support wildcards.
  96.  
  97. Be sure to have the GO32.EXE program somewhere in your PATH.
  98.  
  99.  
  100.  
  101. E2CAT
  102. -----
  103.  
  104. SYNOPSIS
  105.     E2CAT [-bt] pathname
  106.  
  107. DESCTIPTION
  108.     The E2CAT program will copy the contents of the file identified
  109.     by ext2 pathname to the standard output.
  110.  
  111.     The following options are available:
  112.  
  113.     -b    Binary mode. No translation performed.
  114.     
  115.     -t    Text mode (default). LF translated to CR/LF.
  116.  
  117.  
  118.  
  119. E2CD
  120. ----
  121.  
  122. SYNOPSIS
  123.     E2CD pathname
  124.  
  125. DESCRIPTION
  126.     The pathname must identify an ext2 directory. That directory is
  127.     made the current working directory.
  128.  
  129. NOTE
  130.     E2CD is a .BAT file that creates another .BAT file (called
  131.     ___E2CD.BAT) that modifies the E2CWD environment variable. It
  132.     then executes ___E2CD.BAT and deletes it. (So beware if you
  133.     alread have a file called ___E2CD.BAT.)
  134.  
  135.     If you are using 4DOS, add the /Q switch to the DEL command in
  136.     E2CD.BAT.
  137.  
  138.  
  139. E2CP
  140. ----
  141.  
  142. SYNOPSIS
  143.     E2CP [-bt] file1 file2
  144.  
  145. DESCTIPTION
  146.     The E2CP program will copy the contents of the file identified
  147.     by ext2 pathname 'file1' to the MSDOS file 'file2'.
  148.  
  149.     The following options are available:
  150.  
  151.     -b    Binary mode (default). No translation performed.
  152.     
  153.     -t    Text mode. LF translated to CR/LF.
  154.  
  155.  
  156.  
  157. E2LS
  158. ----
  159.  
  160. SYNOPSIS
  161.     E2LS [-adiltr] pathname
  162.  
  163. DESCRIPTION
  164.     The pathname must identify an ext2 directory or file. The E2LS
  165.     program provides a list of the contents of that directory in a
  166.     manner similar to the Linux ls program.
  167.  
  168.     The following options are supported:
  169.  
  170.     -a    Include file names starting with . in listing.
  171.     -d    List only pathname, even if it is a directory.
  172.     -i    Include inode number in listing.
  173.     -l    Produce a long listing.
  174.     -t    Sort by modification time.
  175.     -r    Reverse the sort order.
  176.  
  177.  
  178.  
  179.  
  180. E2PART
  181. ------
  182.  
  183. SYNOPSIS
  184.     E2PART diskno
  185.  
  186. DESCRIPTION
  187.     The E2PART program lists the partitions that are available on a
  188.     particular physical disk. This program does not use the E2CWD
  189.     environment variable, instead the disk number is given as an
  190.     argument to the E2PART program.
  191.  
  192. BUGS
  193.     The program is not very good at identifying MSDOS file systems.
  194.  
  195.  
  196.  
  197. E2PWD
  198. -----
  199.  
  200. SYNOPSIS
  201.     E2PWD
  202.  
  203. DESCRIPTION
  204.     The E2PWD program prints the current directory.
  205.  
  206.  
  207.  
  208.  
  209. HOW TO CONTACT THE AUTHOR
  210. -------------------------
  211.  
  212. The author can be contacted by e-mail at ct@login.dknet.dk.
  213.