| % Copyright 1997 Marco Nelissen. |
| % Copyright 1996-1998,2001,2002,2009 Alain Knaff. |
| % This documentation is for Mtools which is a collection of tools to |
| % allow Unix systems to manipulate MS-DOS files. |
| |
| % Permission is granted to copy, distribute and/or modify this document |
| % under the terms of the GNU Free Documentation License, Version 1.3 or |
| % any later version published by the Free Software Foundation; with no |
| % Invariant Sections, with no Front-Cover Texts, and with no Back-Cover |
| % Texts. A copy of the license is included in the section entitled |
| % ``GNU Free Documentation License''. |
| |
| |
| |
| NOTE: THIS FILE ONLY REFERS TO THE BEBOX. IF YOU ARE USING UNIX, |
| REFER TO README. |
| |
| |
| This is mtools 3.6 for BeOS DR9. This release will no longer work on |
| DR8, which should be no problem since everybody should have upgraded |
| to DR9 by now. mtools 3.6 can be used as a replacement for the |
| version 2.0.7 mtools supplied with BeOS. mtools 3.6 supports the VFAT |
| filesystem (long filenames), which the Be-supplied tools do not. |
| |
| To install: |
| |
| - build the executables: type "make -f Makefile.Be" in the mtools |
| directory. Again, this instruction is only for the Bebox, not for any |
| kind of Unix. They should compile without any warnings or errors. |
| |
| WARNING: do NOT rerun the configure script. Although DR9 bash will |
| no longer lock up when running the configure script, the resulting |
| files are not entirely correct, and mtools will fail to compile. I |
| have hand-crafted a config.h that can be used to compile mtools. This |
| will be used if you just type "make -f Makefile.Be" |
| |
| - copy the "mtools" executable (and perhaps also "mkmanifest") to /bin, |
| or to another directory in your path. |
| |
| Since all of the mtools-commands are contained within a single |
| executable, you must either define aliases for each command, or create |
| links for them. |
| |
| To create aliases, add the following lines to the file /boot/.profile |
| |
| alias mattrib="mtools -c mattrib" |
| alias mbadblocks="mtools -c mbadblocks" |
| alias mcd="mtools -c mcd" |
| alias mcopy="mtools -c mcopy" |
| alias mdel="mtools -c mdel" |
| alias mdeltree="mtools -c mdeltree" |
| alias mdir="mtools -c mdir" |
| alias mformat="mtools -c mformat" |
| alias minfo="mtools -c minfo" |
| alias mlabel="mtools -c mlabel" |
| alias mmd="mtools -c mmd" |
| alias mmount="mtools -c mmount" |
| alias mrd="mtools -c mrd" |
| alias mmove="mtools -c mmove" |
| alias mpartition="mtools -c mpartition" |
| alias mren="mtools -c mren" |
| alias mtoolstest="mtools -c mtoolstest" |
| alias mtest="mtools -c mtest" |
| alias mtype="mtools -c mtype" |
| alias mzip="mtools -c mzip" |
| |
| (then close and re-open all terminals and shells, or type |
| ". /boot/.profile" in each open terminal to activate the |
| aliases. Optional: remove the old mtools from the /bin directory) |
| |
| |
| To create links, open a shell, and type the following commands |
| (assuming you copied the mtools executable to /bin): |
| |
| cd /bin |
| rm mattrib mcd mcopy mdel mdir mformat mkmanifest mlabel mmd mrd mread mren mtype mwrite |
| ln -s mtools mattrib |
| ln -s mtools mbadblocks |
| ln -s mtools mcd |
| ln -s mtools mcopy |
| ln -s mtools mdel |
| ln -s mtools mdeltree |
| ln -s mtools mdir |
| ln -s mtools mformat |
| ln -s mtools minfo |
| ln -s mtools mlabel |
| ln -s mtools mmd |
| ln -s mtools mmount |
| ln -s mtools mrd |
| ln -s mtools mread |
| ln -s mtools mmove |
| ln -s mtools mpartition |
| ln -s mtools mren |
| ln -s mtools mtoolstest |
| ln -s mtools mtest |
| ln -s mtools mtype |
| ln -s mtools mwrite |
| ln -s mtools mzip |
| |
| |
| Alternatively, make multiple copies of the "mtools" executable and use |
| the names mdir, mdel etcetera. |
| |
| - if you want more than just floppy support, you need to make a configuration |
| file. An example mtools.conf.be is included in the distribution. |
| mtools looks in a number of standard places for its config file, such as: |
| /boot/.mtoolsrc |
| /boot/mtools.conf |
| /boot/system/mtools.conf |
| By defining the variable MTOOLSRC you can give the config file any name you |
| like and put it at any location. |
| |
| You need to add something like "export MTOOLSRC=/conf/mtools.cfg" to |
| your .profile file. |
| |
| Take care to remove or change the entries that you don't need. The provided |
| mtools.conf is for unix systems, with some BeOS settings at the end. |
| The sample entry for a ZIP disk on the BeOS has been provided by |
| Chris Herborth |
| (chrish@qnx.com). |
| |
| |
| - enjoy! |
| |
| Marco Nelissen <marcone@xs4all.nl> |
| Alain Knaff <alain@knaff.lu> |
