"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "mtools.info" between
mtools-4.0.36.tar.bz2 and mtools-4.0.37.tar.bz2

About: Mtools is a collection of utilities to access MS-DOS disks from Unix without mounting them.

mtools.info  (mtools-4.0.36.tar.bz2):mtools.info  (mtools-4.0.37.tar.bz2)
This is mtools.info, produced by makeinfo version 6.7 from mtools.texi. This is mtools.info, produced by makeinfo version 6.7 from mtools.texi.
This manual is for Mtools (version 4.0.36, November 2021), which is a This manual is for Mtools (version 4.0.37, January 2022), which is a
collection of tools to allow Unix systems to manipulate MS-DOS files. collection of tools to allow Unix systems to manipulate MS-DOS files.
Copyright (C) 2007, 2009 Free Software Foundation, Inc. Copyright Copyright (C) 2007, 2009 Free Software Foundation, Inc. Copyright
(C) 1996-2005,2007-2011,2013 Alain Knaff. (C) 1996-2005,2007-2011,2013 Alain Knaff.
Permission is granted to copy, distribute and/or modify this Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, document under the terms of the GNU Free Documentation License,
Version 1.3 or any later version published by the Free Software Version 1.3 or any later version published by the Free Software
Foundation; with no Invariant Sections, with no Front-Cover Texts, Foundation; with no Invariant Sections, with no Front-Cover Texts,
and with no Back-Cover Texts. A copy of the license is included in and with no Back-Cover Texts. A copy of the license is included in
skipping to change at line 56 skipping to change at line 56
attempts to emulate the MS-DOS equivalent command. However, unnecessary attempts to emulate the MS-DOS equivalent command. However, unnecessary
restrictions and oddities of DOS are not emulated. For instance, it is restrictions and oddities of DOS are not emulated. For instance, it is
possible to move subdirectories from one subdirectory to another. possible to move subdirectories from one subdirectory to another.
Mtools is sufficient to give access to MS-DOS file systems. For Mtools is sufficient to give access to MS-DOS file systems. For
instance, commands such as 'mdir a:' work on the 'a:' floppy without any instance, commands such as 'mdir a:' work on the 'a:' floppy without any
preliminary mounting or initialization (assuming the default preliminary mounting or initialization (assuming the default
'/etc/mtools.conf' works on your machine). With mtools, one can change '/etc/mtools.conf' works on your machine). With mtools, one can change
floppies too without unmounting and mounting. floppies too without unmounting and mounting.
This manual is for Mtools (version 4.0.36, November 2021), which is a This manual is for Mtools (version 4.0.37, January 2022), which is a
collection of tools to allow Unix systems to manipulate MS-DOS files. collection of tools to allow Unix systems to manipulate MS-DOS files.
Copyright (C) 2007, 2009 Free Software Foundation, Inc. Copyright Copyright (C) 2007, 2009 Free Software Foundation, Inc. Copyright
(C) 1996-2005,2007-2011,2013 Alain Knaff. (C) 1996-2005,2007-2011,2013 Alain Knaff.
Permission is granted to copy, distribute and/or modify this Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, document under the terms of the GNU Free Documentation License,
Version 1.3 or any later version published by the Free Software Version 1.3 or any later version published by the Free Software
Foundation; with no Invariant Sections, with no Front-Cover Texts, Foundation; with no Invariant Sections, with no Front-Cover Texts,
and with no Back-Cover Texts. A copy of the license is included in and with no Back-Cover Texts. A copy of the license is included in
skipping to change at line 90 skipping to change at line 90
* Variable Index:: Variable Index * Variable Index:: Variable Index
* Concept Index:: Concept Index * Concept Index:: Concept Index
 
File: mtools.info, Node: Location, Next: Common features, Prev: Top, Up: Top File: mtools.info, Node: Location, Next: Common features, Prev: Top, Up: Top
1 Where to get mtools 1 Where to get mtools
********************* *********************
Mtools can be found at the following places (and their mirrors): Mtools can be found at the following places (and their mirrors):
http://ftp.gnu.org/gnu/mtools/mtools-4.0.36.tar.gz http://ftp.gnu.org/gnu/mtools/mtools-4.0.37.tar.gz
These patches are named 'mtools-'VERSION'-'DDMM'.taz', where version These patches are named 'mtools-'VERSION'-'DDMM'.taz', where version
stands for the base version, DD for the day and MM for the month. Due stands for the base version, DD for the day and MM for the month. Due
to a lack of space, I usually leave only the most recent patch. to a lack of space, I usually leave only the most recent patch.
There is an mtools mailing list at info-mtools @ gnu.org . Please There is an mtools mailing list at info-mtools @ gnu.org . Please
send all bug reports to this list. You may subscribe to the list at send all bug reports to this list. You may subscribe to the list at
https://lists.gnu.org/mailman/listinfo/info-mtools. (N.B. Please remove https://lists.gnu.org/mailman/listinfo/info-mtools. (N.B. Please remove
the spaces around the "@". I left them there in order to fool the spaces around the "@". I left them there in order to fool
spambots.) Announcements of new mtools versions will also be sent to spambots.) Announcements of new mtools versions will also be sent to
skipping to change at line 152 skipping to change at line 152
are ignored during pattern matching. are ignored during pattern matching.
All options use the '-' (minus) as their first character, not '/' as All options use the '-' (minus) as their first character, not '/' as
you'd expect in MS-DOS. you'd expect in MS-DOS.
Most mtools commands allow multiple filename parameters, which Most mtools commands allow multiple filename parameters, which
doesn't follow MS-DOS conventions, but which is more user-friendly. doesn't follow MS-DOS conventions, but which is more user-friendly.
Most mtools commands allow options that instruct them how to handle Most mtools commands allow options that instruct them how to handle
file name clashes. *Note name clashes::, for more details on these. file name clashes. *Note name clashes::, for more details on these.
All commands accept the '-V' flags which prints the version, and most
All commands accept the '-i' flag which allows to specify an image
file (*Note drive letters::).
All commands accept the '-V' flag which prints the version, and most
accept the '-v' flag, which switches on verbose mode. In verbose mode, accept the '-v' flag, which switches on verbose mode. In verbose mode,
these commands print out the name of the MS-DOS files upon which they these commands print out the name of the MS-DOS files upon which they
act, unless stated otherwise. *Note Commands::, for a description of act, unless stated otherwise. *Note Commands::, for a description of
the options which are specific to each command. the options which are specific to each command.
 
File: mtools.info, Node: drive letters, Next: directory, Prev: arguments, Up : Common features File: mtools.info, Node: drive letters, Next: directory, Prev: arguments, Up : Common features
2.2 Drive letters 2.2 Drive letters
================= =================
skipping to change at line 1076 skipping to change at line 1080
description of those. description of those.
* Menu: * Menu:
* floppyd:: floppy daemon to run on your X server box * floppyd:: floppy daemon to run on your X server box
* floppyd_installtest:: small utility to check for the presence of floppyd * floppyd_installtest:: small utility to check for the presence of floppyd
* mattrib:: change MS-DOS file attribute flags * mattrib:: change MS-DOS file attribute flags
* mbadblocks:: tests a floppy disk, and marks the bad blocks in the FAT * mbadblocks:: tests a floppy disk, and marks the bad blocks in the FAT
* mcat:: same as cat. Only useful with floppyd. * mcat:: same as cat. Only useful with floppyd.
* mcd:: change MS-DOS directory * mcd:: change MS-DOS directory
* mclasserase:: erase memory card
* mcopy:: copy MS-DOS files to/from Unix * mcopy:: copy MS-DOS files to/from Unix
* mdel:: delete an MS-DOS file * mdel:: delete an MS-DOS file
* mdeltree:: recursively delete an MS-DOS directory * mdeltree:: recursively delete an MS-DOS directory
* mdir:: display an MS-DOS directory * mdir:: display an MS-DOS directory
* mdu:: list space occupied by directory and its contents * mdu:: list space occupied by directory and its contents
* mformat:: add an MS-DOS file system to a low-level formatted floppy disk * mformat:: add an MS-DOS file system to a low-level formatted floppy disk
* minfo:: get information about an MS-DOS file system. * minfo:: get information about an MS-DOS file system.
* mlabel:: make an MS-DOS volume label * mlabel:: make an MS-DOS volume label
* mkmanifest:: makes a list of short name equivalents * mkmanifest:: makes a list of short name equivalents
* mmd:: make an MS-DOS subdirectory * mmd:: make an MS-DOS subdirectory
skipping to change at line 1343 skipping to change at line 1346
to create boot floppies remotely. to create boot floppies remotely.
The default operation is reading. The output is written to stdout. The default operation is reading. The output is written to stdout.
If the '-w' option is specified, mcat reads a disk-image from stdin If the '-w' option is specified, mcat reads a disk-image from stdin
and writes it to the given device. *Use this carefully!* Because of and writes it to the given device. *Use this carefully!* Because of
the low-level nature of this command, it will happily destroy any data the low-level nature of this command, it will happily destroy any data
written before on the disk without warning! written before on the disk without warning!
 
File: mtools.info, Node: mcd, Next: mclasserase, Prev: mcat, Up: Commands File: mtools.info, Node: mcd, Next: mcopy, Prev: mcat, Up: Commands
4.6 Mcd 4.6 Mcd
======= =======
The 'mcd' command is used to change the mtools working directory on the The 'mcd' command is used to change the mtools working directory on the
MS-DOS disk. It uses the following syntax: MS-DOS disk. It uses the following syntax:
mcd [MSDOSDIRECTORY] mcd [MSDOSDIRECTORY]
Without arguments, 'mcd' reports the current device and working Without arguments, 'mcd' reports the current device and working
skipping to change at line 1368 skipping to change at line 1371
where the device and current working directory information is stored. where the device and current working directory information is stored.
The default is '$HOME/.mcwd'. Information in this file is ignored if The default is '$HOME/.mcwd'. Information in this file is ignored if
the file is more than 6 hours old. the file is more than 6 hours old.
'Mcd' returns 0 on success or 1 on failure. 'Mcd' returns 0 on success or 1 on failure.
Unlike MS-DOS versions of 'CD', 'mcd' can be used to change to Unlike MS-DOS versions of 'CD', 'mcd' can be used to change to
another device. It may be wise to remove old '.mcwd' files at logout. another device. It may be wise to remove old '.mcwd' files at logout.
 
File: mtools.info, Node: mclasserase, Next: mcopy, Prev: mcd, Up: Commands File: mtools.info, Node: mcopy, Next: mdel, Prev: mcd, Up: Commands
4.7 Mclasserase
===============
The 'mclasserase' command is used to wipe memory cards by overwriting it
three times: first with '0xff', then with '0x00', then with '0xff'
again. The command uses the following syntax:
mclasserase [-d] MSDOSDRIVE
MS-DOS drive is optional, if none is specified, use 'A:'. If more
than one drive are specified, all but the last are ignored.
'Mclasserase' accepts the following command line options:
'd'
Stop after each erase cycle, for testing purposes
'p'
Not yet implemented
'Mclasserase' returns 0 on success or -1 on failure.

File: mtools.info, Node: mcopy, Next: mdel, Prev: mclasserase, Up: Commands
4.8 Mcopy 4.7 Mcopy
========= =========
The 'mcopy' command is used to copy MS-DOS files to and from Unix. It The 'mcopy' command is used to copy MS-DOS files to and from Unix. It
uses the following syntax: uses the following syntax:
mcopy [-bspanvmQT] [-D CLASH_OPTION] SOURCEFILE TARGETFILE mcopy [-bspanvmQT] [-D CLASH_OPTION] SOURCEFILE TARGETFILE
mcopy [-bspanvmQT] [-D CLASH_OPTION] SOURCEFILE [ SOURCEFILES... ] TARGETDI RECTORY mcopy [-bspanvmQT] [-D CLASH_OPTION] SOURCEFILE [ SOURCEFILES... ] TARGETDI RECTORY
mcopy [-tnvm] MSDOSSOURCEFILE mcopy [-tnvm] MSDOSSOURCEFILE
'Mcopy' copies the specified file to the named file, or copies 'Mcopy' copies the specified file to the named file, or copies
skipping to change at line 1458 skipping to change at line 1437
the user when overwriting an existing Unix file. If the target the user when overwriting an existing Unix file. If the target
file already exists, and the '-n' option is not in effect, 'mcopy' file already exists, and the '-n' option is not in effect, 'mcopy'
asks whether to overwrite the file or to rename the new file (see asks whether to overwrite the file or to rename the new file (see
*note name clashes::) for details). In order to switch off *note name clashes::) for details). In order to switch off
confirmation for DOS files, use '-o'. confirmation for DOS files, use '-o'.
'm' 'm'
Preserve the file modification time. Preserve the file modification time.
'v' 'v'
Verbose. Displays the name of each file as it is copied. Verbose. Displays the name of each file as it is copied.
4.8.1 Bugs 4.7.1 Bugs
---------- ----------
Unlike MS-DOS, the '+' operator (append) from MS-DOS is not supported. Unlike MS-DOS, the '+' operator (append) from MS-DOS is not supported.
However, you may use 'mtype' to produce the same effect: However, you may use 'mtype' to produce the same effect:
mtype a:file1 a:file2 a:file3 >unixfile mtype a:file1 a:file2 a:file3 >unixfile
mtype a:file1 a:file2 a:file3 | mcopy - a:msdosfile mtype a:file1 a:file2 a:file3 | mcopy - a:msdosfile
 
File: mtools.info, Node: mdel, Next: mdeltree, Prev: mcopy, Up: Commands File: mtools.info, Node: mdel, Next: mdeltree, Prev: mcopy, Up: Commands
4.9 Mdel 4.8 Mdel
======== ========
The 'mdel' command is used to delete an MS-DOS file. Its syntax is: The 'mdel' command is used to delete an MS-DOS file. Its syntax is:
'mdel' ['-v'] MSDOSFILE [ MSDOSFILES ... ] 'mdel' ['-v'] MSDOSFILE [ MSDOSFILES ... ]
'Mdel' deletes files on an MS-DOS file system. 'Mdel' deletes files on an MS-DOS file system.
'Mdel' asks for verification prior to removing a read-only file. 'Mdel' asks for verification prior to removing a read-only file.
 
File: mtools.info, Node: mdeltree, Next: mdir, Prev: mdel, Up: Commands File: mtools.info, Node: mdeltree, Next: mdir, Prev: mdel, Up: Commands
4.10 Mdeltree 4.9 Mdeltree
============= ============
The 'mdeltree' command is used to delete an MS-DOS file. Its syntax is: The 'mdeltree' command is used to delete an MS-DOS file. Its syntax is:
'mdeltree' ['-v'] MSDOSDIRECTORY [MSDOSDIRECTORIES...] 'mdeltree' ['-v'] MSDOSDIRECTORY [MSDOSDIRECTORIES...]
'Mdeltree' removes a directory and all the files and subdirectories 'Mdeltree' removes a directory and all the files and subdirectories
it contains from an MS-DOS file system. An error occurs if the it contains from an MS-DOS file system. An error occurs if the
directory to be removed does not exist. directory to be removed does not exist.
 
File: mtools.info, Node: mdir, Next: mdu, Prev: mdeltree, Up: Commands File: mtools.info, Node: mdir, Next: mdu, Prev: mdeltree, Up: Commands
4.11 Mdir 4.10 Mdir
========= =========
The 'mdir' command is used to display an MS-DOS directory. Its syntax The 'mdir' command is used to display an MS-DOS directory. Its syntax
is: is:
'mdir' ['-/'] ['-f'] ['-w'] ['-a'] ['-b'] MSDOSFILE [ MSDOSFILES...] 'mdir' ['-/'] ['-f'] ['-w'] ['-a'] ['-b'] MSDOSFILE [ MSDOSFILES...]
'Mdir' displays the contents of MS-DOS directories, or the entries 'Mdir' displays the contents of MS-DOS directories, or the entries
for some MS-DOS files. for some MS-DOS files.
skipping to change at line 1534 skipping to change at line 1513
Concise listing. Lists each directory name or filename, one per Concise listing. Lists each directory name or filename, one per
line (including the filename extension). This switch displays no line (including the filename extension). This switch displays no
heading information and no summary. Only a newline separated list heading information and no summary. Only a newline separated list
of pathnames is displayed. of pathnames is displayed.
An error occurs if a component of the path is not a directory. An error occurs if a component of the path is not a directory.
 
File: mtools.info, Node: mdu, Next: mformat, Prev: mdir, Up: Commands File: mtools.info, Node: mdu, Next: mformat, Prev: mdir, Up: Commands
4.12 Mdu 4.11 Mdu
======== ========
'Mdu' is used to list the space occupied by a directory, its 'Mdu' is used to list the space occupied by a directory, its
subdirectories and its files. It is similar to the 'du' command on subdirectories and its files. It is similar to the 'du' command on
Unix. The unit used are clusters. Use the minfo command to find out Unix. The unit used are clusters. Use the minfo command to find out
the cluster size. the cluster size.
'mdu' ['-a'] [ MSDOSFILES ... ] 'mdu' ['-a'] [ MSDOSFILES ... ]
'a' 'a'
All files. List also the space occupied for individual files. All files. List also the space occupied for individual files.
's' 's'
Only list the total space, don't give details for each Only list the total space, don't give details for each
subdirectory. subdirectory.
 
File: mtools.info, Node: mformat, Next: mkmanifest, Prev: mdu, Up: Commands File: mtools.info, Node: mformat, Next: mkmanifest, Prev: mdu, Up: Commands
4.13 Mformat 4.12 Mformat
============ ============
The 'mformat' command is used to add an MS-DOS file system to a The 'mformat' command is used to add an MS-DOS file system to a
low-level formatted diskette. Its syntax is: low-level formatted diskette. Its syntax is:
'mformat' ['-t' CYLINDERS|'-T' TOT_SECTORS] ['-h' HEADS] ['-s' SECTORS] 'mformat' ['-t' CYLINDERS|'-T' TOT_SECTORS] ['-h' HEADS] ['-s' SECTORS]
['-f' SIZE] ['-1'] ['-4'] ['-8'] ['-f' SIZE] ['-1'] ['-4'] ['-8']
['-v' VOLUME_LABEL] ['-v' VOLUME_LABEL]
['-F'] ['-S' SIZECODE] ['-F'] ['-S' SIZECODE]
['-M' SOFTWARE_SECTOR_SIZE] ['-M' SOFTWARE_SECTOR_SIZE]
skipping to change at line 1745 skipping to change at line 1724
To format a diskette at a density other than the default, you must To format a diskette at a density other than the default, you must
supply (at least) those command line parameters that are different from supply (at least) those command line parameters that are different from
the default. the default.
'Mformat' returns 0 on success or 1 on failure. 'Mformat' returns 0 on success or 1 on failure.
It doesn't record bad block information to the Fat, use 'mbadblocks' It doesn't record bad block information to the Fat, use 'mbadblocks'
for that. for that.
4.13.1 Number of sectors per cluster 4.12.1 Number of sectors per cluster
------------------------------------ ------------------------------------
If the user indicates no cluster size, mformat figures out a default If the user indicates no cluster size, mformat figures out a default
value for it. value for it.
For FAT32 it uses the following table to determine the number of For FAT32 it uses the following table to determine the number of
sectors per cluster, depending on the total number of sectors on the sectors per cluster, depending on the total number of sectors on the
filesystem. filesystem.
more than 32*1024*1024*2: 64 sectors more than 32*1024*1024*2: 64 sectors
skipping to change at line 1780 skipping to change at line 1759
The starting value is 1 for disks with one head or less than 2000 The starting value is 1 for disks with one head or less than 2000
sectors, and 2 for disks with more than one head, and more than 2000 sectors, and 2 for disks with more than one head, and more than 2000
sectors. sectors.
The number of sectors per cluster cannot go beyond 128. The number of sectors per cluster cannot go beyond 128.
 
File: mtools.info, Node: mkmanifest, Next: minfo, Prev: mformat, Up: Command s File: mtools.info, Node: mkmanifest, Next: minfo, Prev: mformat, Up: Command s
4.14 Mkmanifest 4.13 Mkmanifest
=============== ===============
The 'mkmanifest' command is used to create a shell script (packing list) The 'mkmanifest' command is used to create a shell script (packing list)
to restore Unix filenames. Its syntax is: to restore Unix filenames. Its syntax is:
'mkmanifest' [ FILES ] 'mkmanifest' [ FILES ]
'Mkmanifest' creates a shell script that aids in the restoration of 'Mkmanifest' creates a shell script that aids in the restoration of
Unix filenames that got clobbered by the MS-DOS filename restrictions. Unix filenames that got clobbered by the MS-DOS filename restrictions.
MS-DOS filenames are restricted to 8 character names, 3 character MS-DOS filenames are restricted to 8 character names, 3 character
extensions, upper case only, no device names, and no illegal characters. extensions, upper case only, no device names, and no illegal characters.
The mkmanifest program is compatible with the methods used in 'pcomm, The mkmanifest program is compatible with the methods used in 'pcomm,
arc,' and 'mtools' to change perfectly good Unix filenames to fit the arc,' and 'mtools' to change perfectly good Unix filenames to fit the
MS-DOS restrictions. This command is only useful if the target system MS-DOS restrictions. This command is only useful if the target system
which will read the diskette cannot handle VFAT long names. which will read the diskette cannot handle VFAT long names.
4.14.1 Example 4.13.1 Example
-------------- --------------
You want to copy the following Unix files to a MS-DOS diskette (using You want to copy the following Unix files to a MS-DOS diskette (using
the 'mcopy' command). the 'mcopy' command).
very_long_name very_long_name
2.many.dots 2.many.dots
illegal: illegal:
good.c good.c
prn.dev prn.dev
skipping to change at line 1837 skipping to change at line 1816
mv capital Capital mv capital Capital
Notice that "good.c" did not require any conversion, so it did not Notice that "good.c" did not require any conversion, so it did not
appear in the output. appear in the output.
Suppose I've copied these files from the diskette to another Unix Suppose I've copied these files from the diskette to another Unix
system, and I now want the files back to their original names. If the system, and I now want the files back to their original names. If the
file "manifest" (the output captured above) was sent along with those file "manifest" (the output captured above) was sent along with those
files, it could be used to convert the filenames. files, it could be used to convert the filenames.
4.14.2 Bugs 4.13.2 Bugs
----------- -----------
The short names generated by 'mkmanifest' follow the old convention The short names generated by 'mkmanifest' follow the old convention
(from mtools-2.0.7) and not the one from Windows 95 and mtools-3.0. (from mtools-2.0.7) and not the one from Windows 95 and mtools-3.0.
 
File: mtools.info, Node: minfo, Next: mlabel, Prev: mkmanifest, Up: Commands File: mtools.info, Node: minfo, Next: mlabel, Prev: mkmanifest, Up: Commands
4.15 Minfo 4.14 Minfo
========== ==========
The 'minfo' command prints the parameters of a MS-DOS file system, such The 'minfo' command prints the parameters of a MS-DOS file system, such
as number of sectors, heads and cylinders. It also prints an mformat as number of sectors, heads and cylinders. It also prints an mformat
command line which can be used to create a similar MS-DOS file system on command line which can be used to create a similar MS-DOS file system on
another media. However, this doesn't work with 2m or XDF media, and another media. However, this doesn't work with 2m or XDF media, and
with MS-DOS 1.0 file systems with MS-DOS 1.0 file systems
'minfo' DRIVE: 'minfo' DRIVE:
Minfo supports the following option: Minfo supports the following option:
'v' 'v'
Prints a hexdump of the boot sector, in addition to the other Prints a hexdump of the boot sector, in addition to the other
information information
 
File: mtools.info, Node: mlabel, Next: mmd, Prev: minfo, Up: Commands File: mtools.info, Node: mlabel, Next: mmd, Prev: minfo, Up: Commands
4.16 Mlabel 4.15 Mlabel
=========== ===========
The 'mlabel' command adds a volume label to a disk. Its syntax is: The 'mlabel' command adds a volume label to a disk. Its syntax is:
'mlabel' ['-vcsn'] ['-N' SERIAL] DRIVE:[NEW_LABEL] 'mlabel' ['-vcsn'] ['-N' SERIAL] DRIVE:[NEW_LABEL]
'Mlabel' displays the current volume label, if present. If NEW_LABEL 'Mlabel' displays the current volume label, if present. If NEW_LABEL
is not given, and if neither the 'c' nor the 's' options are set, it is not given, and if neither the 'c' nor the 's' options are set, it
prompts the user for a new volume label. To delete an existing volume prompts the user for a new volume label. To delete an existing volume
label, press return at the prompt. label, press return at the prompt.
skipping to change at line 1897 skipping to change at line 1876
Shows the existing label, without prompting the user. Shows the existing label, without prompting the user.
'n' 'n'
Assigns a new (random) serial number to the disk Assigns a new (random) serial number to the disk
'N SERIAL' 'N SERIAL'
Sets the supplied serial number. The serial number should be Sets the supplied serial number. The serial number should be
supplied as an 8 digit hexadecimal number, without spaces supplied as an 8 digit hexadecimal number, without spaces
 
File: mtools.info, Node: mmd, Next: mmount, Prev: mlabel, Up: Commands File: mtools.info, Node: mmd, Next: mmount, Prev: mlabel, Up: Commands
4.17 Mmd 4.16 Mmd
======== ========
The 'mmd' command is used to make an MS-DOS subdirectory. Its syntax The 'mmd' command is used to make an MS-DOS subdirectory. Its syntax
is: is:
'mmd' ['-D' CLASH_OPTION] MSDOSDIRECTORY [ MSDOSDIRECTORIES... ] 'mmd' ['-D' CLASH_OPTION] MSDOSDIRECTORY [ MSDOSDIRECTORIES... ]
'Mmd' makes a new directory on an MS-DOS file system. An error 'Mmd' makes a new directory on an MS-DOS file system. An error
occurs if the directory already exists. occurs if the directory already exists.
 
File: mtools.info, Node: mmount, Next: mmove, Prev: mmd, Up: Commands File: mtools.info, Node: mmount, Next: mmove, Prev: mmd, Up: Commands
4.18 Mmount 4.17 Mmount
=========== ===========
The 'mmount' command is used to mount an MS-DOS disk. It is only The 'mmount' command is used to mount an MS-DOS disk. It is only
available on Linux, as it is only useful if the OS kernel allows available on Linux, as it is only useful if the OS kernel allows
configuration of the disk geometry. Its syntax is: configuration of the disk geometry. Its syntax is:
'mmount' MSDOSDRIVE [MOUNTARGS] 'mmount' MSDOSDRIVE [MOUNTARGS]
'Mmount' reads the boot sector of an MS-DOS disk, configures the 'Mmount' reads the boot sector of an MS-DOS disk, configures the
drive geometry, and finally mounts it passing 'mountargs' to 'mount. ' drive geometry, and finally mounts it passing 'mountargs' to 'mount. '
If no mount arguments are specified, the name of the device is used. If If no mount arguments are specified, the name of the device is used. If
the disk is write protected, it is automatically mounted read only. the disk is write protected, it is automatically mounted read only.
 
File: mtools.info, Node: mmove, Next: mpartition, Prev: mmount, Up: Commands File: mtools.info, Node: mmove, Next: mpartition, Prev: mmount, Up: Commands
4.19 Mmove 4.18 Mmove
========== ==========
The 'mmove' command is used to move or rename an existing MS-DOS file or The 'mmove' command is used to move or rename an existing MS-DOS file or
subdirectory. subdirectory.
'mmove' ['-v'] ['-D' CLASH_OPTION] SOURCEFILE TARGETFILE 'mmove' ['-v'] ['-D' CLASH_OPTION] SOURCEFILE TARGETFILE
'mmove' ['-v'] ['-D' CLASH_OPTION] SOURCEFILE [ SOURCEFILES... ] TARGETDIR ECTORY 'mmove' ['-v'] ['-D' CLASH_OPTION] SOURCEFILE [ SOURCEFILES... ] TARGETDIR ECTORY
'Mmove' moves or renames an existing MS-DOS file or subdirectory. 'Mmove' moves or renames an existing MS-DOS file or subdirectory.
Unlike the MS-DOS version of 'MOVE', 'mmove' is able to move Unlike the MS-DOS version of 'MOVE', 'mmove' is able to move
subdirectories. Files or directories can only be moved within one file subdirectories. Files or directories can only be moved within one file
system. Data cannot be moved from MS-DOS to Unix or vice-versa. If you system. Data cannot be moved from MS-DOS to Unix or vice-versa. If you
omit the drive letter from the target file or directory, the same letter omit the drive letter from the target file or directory, the same letter
as for the source is assumed. If you omit the drive letter from all as for the source is assumed. If you omit the drive letter from all
parameters, drive a: is assumed by default. parameters, drive a: is assumed by default.
 
File: mtools.info, Node: mpartition, Next: mrd, Prev: mmove, Up: Commands File: mtools.info, Node: mpartition, Next: mrd, Prev: mmove, Up: Commands
4.20 Mpartition 4.19 Mpartition
=============== ===============
The 'mpartition' command is used to create MS-DOS file systems as The 'mpartition' command is used to create MS-DOS file systems as
partitions. This is intended to be used on non-Linux systems, i.e. partitions. This is intended to be used on non-Linux systems, i.e.
systems where fdisk and easy access to SCSI devices are not available. systems where fdisk and easy access to SCSI devices are not available.
This command only works on drives whose partition variable is set. This command only works on drives whose partition variable is set.
'mpartition' '-p' DRIVE 'mpartition' '-p' DRIVE
'mpartition' '-r' DRIVE 'mpartition' '-r' DRIVE
'mpartition' '-I' ['-B' BOOTSECTOR] DRIVE 'mpartition' '-I' ['-B' BOOTSECTOR] DRIVE
skipping to change at line 2030 skipping to change at line 2009
change operation), or as it is after it is modified. change operation), or as it is after it is modified.
'vv' 'vv'
If the verbosity flag is given twice, 'mpartition' will print out a If the verbosity flag is given twice, 'mpartition' will print out a
hexdump of the partition table when reading it from and writing it hexdump of the partition table when reading it from and writing it
to the device. to the device.
The following option is available for partition table initialization: The following option is available for partition table initialization:
'B BOOTSECTOR' 'B BOOTSECTOR'
Reads the template master boot record from file BOOTSECTOR. Reads the template master boot record from file BOOTSECTOR.
4.20.1 Choice of partition type 4.19.1 Choice of partition type
------------------------------- -------------------------------
Mpartition proceeds as follows to pick a type for the partition: Mpartition proceeds as follows to pick a type for the partition:
- FAT32 partitions are assigned type 0x0C ("'Win95 FAT32, LBA'") - FAT32 partitions are assigned type 0x0C ("'Win95 FAT32, LBA'")
- For all others, if the partition fits entirely within the first - For all others, if the partition fits entirely within the first
65536 sectors of the disk, assign 0x01 ("'DOS FAT12, CHS'") for 65536 sectors of the disk, assign 0x01 ("'DOS FAT12, CHS'") for
FAT12 partition and 0x04 ("'DOS FAT16, CHS'") for FAT16 partitions FAT12 partition and 0x04 ("'DOS FAT16, CHS'") for FAT16 partitions
skipping to change at line 2073 skipping to change at line 2052
1024 cylinders. This is because any partition beyond 1024 1024 cylinders. This is because any partition beyond 1024
cylinders must be LBA and cannot be CHS. 8GB works out to be the cylinders must be LBA and cannot be CHS. 8GB works out to be the
biggest capacity which can be represented as CHS (63 sectors, 255 biggest capacity which can be represented as CHS (63 sectors, 255
heads and 1024 cylinders). 4GB is the capacity limit for windows heads and 1024 cylinders). 4GB is the capacity limit for windows
2000, so it makes sense that a documentation for windows 2000 would 2000, so it makes sense that a documentation for windows 2000 would
specify this as the upper limit for any partition type. specify this as the upper limit for any partition type.
 
File: mtools.info, Node: mrd, Next: mren, Prev: mpartition, Up: Commands File: mtools.info, Node: mrd, Next: mren, Prev: mpartition, Up: Commands
4.21 Mrd 4.20 Mrd
======== ========
The 'mrd' command is used to remove an MS-DOS subdirectory. Its syntax The 'mrd' command is used to remove an MS-DOS subdirectory. Its syntax
is: is:
'mrd' ['-v'] MSDOSDIRECTORY [ MSDOSDIRECTORIES... ] 'mrd' ['-v'] MSDOSDIRECTORY [ MSDOSDIRECTORIES... ]
'Mrd' removes a directory from an MS-DOS file system. An error 'Mrd' removes a directory from an MS-DOS file system. An error
occurs if the directory does not exist or is not empty. occurs if the directory does not exist or is not empty.
 
File: mtools.info, Node: mren, Next: mshortname, Prev: mrd, Up: Commands File: mtools.info, Node: mren, Next: mshortname, Prev: mrd, Up: Commands
4.22 Mren 4.21 Mren
========= =========
The 'mren' command is used to rename or move an existing MS-DOS file or The 'mren' command is used to rename or move an existing MS-DOS file or
subdirectory. Its syntax is: subdirectory. Its syntax is:
'mren' ['-voOsSrRA'] SOURCEFILE TARGETFILE 'mren' ['-voOsSrRA'] SOURCEFILE TARGETFILE
'Mren' renames an existing file on an MS-DOS file system. 'Mren' renames an existing file on an MS-DOS file system.
In verbose mode, 'Mren' displays the new filename if the name In verbose mode, 'Mren' displays the new filename if the name
skipping to change at line 2109 skipping to change at line 2088
If the first syntax is used (only one source file), and if the target If the first syntax is used (only one source file), and if the target
name doesn't contain any slashes or colons, the file (or subdirectory) name doesn't contain any slashes or colons, the file (or subdirectory)
is renamed in the same directory, instead of being moved to the current is renamed in the same directory, instead of being moved to the current
'mcd' directory as would be the case with 'mmove'. Unlike the MS-DOS 'mcd' directory as would be the case with 'mmove'. Unlike the MS-DOS
version of 'REN', 'mren' can be used to rename directories. version of 'REN', 'mren' can be used to rename directories.
 
File: mtools.info, Node: mshortname, Next: mshowfat, Prev: mren, Up: Command s File: mtools.info, Node: mshortname, Next: mshowfat, Prev: mren, Up: Command s
4.23 Mshortname 4.22 Mshortname
=============== ===============
The 'mshortname' command is used to display the short name of a file. The 'mshortname' command is used to display the short name of a file.
Syntax: Syntax:
'mshortname' FILES 'mshortname' FILES
The shortname is displayed as it is stored in raw format on disk, The shortname is displayed as it is stored in raw format on disk,
without any character set conversion. without any character set conversion.
 
File: mtools.info, Node: mshowfat, Next: mtoolstest, Prev: mshortname, Up: C ommands File: mtools.info, Node: mshowfat, Next: mtoolstest, Prev: mshortname, Up: C ommands
4.24 Mshowfat 4.23 Mshowfat
============= =============
The 'mshowfat' command is used to display the FAT entries for a file. The 'mshowfat' command is used to display the FAT entries for a file.
Syntax: Syntax:
'mshowfat' ['-o' OFFSET] FILES 'mshowfat' ['-o' OFFSET] FILES
If no offset is given, a list of all clusters occupied by the file is If no offset is given, a list of all clusters occupied by the file is
printed. If an offset is given, only the number of the cluster printed. If an offset is given, only the number of the cluster
containing that offset is printed. containing that offset is printed.
 
File: mtools.info, Node: mtoolstest, Next: mtype, Prev: mshowfat, Up: Comman ds File: mtools.info, Node: mtoolstest, Next: mtype, Prev: mshowfat, Up: Comman ds
4.25 Mtoolstest 4.24 Mtoolstest
=============== ===============
The 'mtoolstest' command is used to tests the mtools configuration The 'mtoolstest' command is used to tests the mtools configuration
files. To invoke it, just type 'mtoolstest' without any arguments. files. To invoke it, just type 'mtoolstest' without any arguments.
'Mtoolstest' reads the mtools configuration files, and prints the 'Mtoolstest' reads the mtools configuration files, and prints the
cumulative configuration to 'stdout'. The output can be used as a cumulative configuration to 'stdout'. The output can be used as a
configuration file itself (although you might want to remove redundant configuration file itself (although you might want to remove redundant
clauses). You may use this program to convert old-style configuration clauses). You may use this program to convert old-style configuration
files into new style configuration files. files into new style configuration files.
 
File: mtools.info, Node: mtype, Next: mzip, Prev: mtoolstest, Up: Commands File: mtools.info, Node: mtype, Next: mzip, Prev: mtoolstest, Up: Commands
4.26 Mtype 4.25 Mtype
========== ==========
The 'mtype' command is used to display contents of an MS-DOS file. Its The 'mtype' command is used to display contents of an MS-DOS file. Its
syntax is: syntax is:
'mtype' ['-ts'] MSDOSFILE [ MSDOSFILES... ] 'mtype' ['-ts'] MSDOSFILE [ MSDOSFILES... ]
'Mtype' displays the specified MS-DOS file on the screen. 'Mtype' displays the specified MS-DOS file on the screen.
In addition to the standard options, 'Mtype' allows the following In addition to the standard options, 'Mtype' allows the following
skipping to change at line 2183 skipping to change at line 2162
'Mtype' returns 0 on success, 1 on utter failure, or 2 on partial 'Mtype' returns 0 on success, 1 on utter failure, or 2 on partial
failure. failure.
Unlike the MS-DOS version of 'TYPE', 'mtype' allows multiple Unlike the MS-DOS version of 'TYPE', 'mtype' allows multiple
arguments. arguments.
 
File: mtools.info, Node: mzip, Prev: mtype, Up: Commands File: mtools.info, Node: mzip, Prev: mtype, Up: Commands
4.27 Mzip 4.26 Mzip
========= =========
The 'mzip' command is used to issue ZIP disk specific commands on Linux, The 'mzip' command is used to issue ZIP disk specific commands on Linux,
Solaris or HP-UX. Its syntax is: Solaris or HP-UX. Its syntax is:
'mzip' ['-epqrwx'] 'mzip' ['-epqrwx']
'Mzip' allows the following command line options: 'Mzip' allows the following command line options:
'e' 'e'
skipping to change at line 2228 skipping to change at line 2207
On MS-DOS or on a Mac, this password is automatically removed once the On MS-DOS or on a Mac, this password is automatically removed once the
ZipTools have been installed. From various articles posted to Usenet, I ZipTools have been installed. From various articles posted to Usenet, I
learned that the password for the tools disk is 'APlaceForYourStuff'(1). learned that the password for the tools disk is 'APlaceForYourStuff'(1).
Mzip knows about this password, and tries it first, before prompting you Mzip knows about this password, and tries it first, before prompting you
for a password. Thus 'mzip -w z:' unlocks the tools disk(2). The tools for a password. Thus 'mzip -w z:' unlocks the tools disk(2). The tools
disk is formatted in a special way so as to be usable both in a PC and disk is formatted in a special way so as to be usable both in a PC and
in a Mac. On a PC, the Mac file system appears as a hidden file named in a Mac. On a PC, the Mac file system appears as a hidden file named
'partishn.mac'. You may erase it to reclaim the 50 Megs of space taken 'partishn.mac'. You may erase it to reclaim the 50 Megs of space taken
up by the Mac file system. up by the Mac file system.
4.27.1 Bugs 4.26.1 Bugs
----------- -----------
This command is a big kludge. A proper implementation would take a This command is a big kludge. A proper implementation would take a
rework of significant parts of mtools, but unfortunately I don't have rework of significant parts of mtools, but unfortunately I don't have
the time for this right now. The main downside of this implementation the time for this right now. The main downside of this implementation
is that it is inefficient on some architectures (several successive is that it is inefficient on some architectures (several successive
calls to mtools, which defeats mtools' caching). calls to mtools, which defeats mtools' caching).
---------- Footnotes ---------- ---------- Footnotes ----------
skipping to change at line 2597 skipping to change at line 2576
* Low density disk: geometry description. (line 6) * Low density disk: geometry description. (line 6)
* Magneto-optical disks: location information. (line 14) * Magneto-optical disks: location information. (line 14)
* mailing list: Location. (line 6) * mailing list: Location. (line 6)
* Making a directory: mmd. (line 6) * Making a directory: mmd. (line 6)
* Marking blocks as bad: mbadblocks. (line 6) * Marking blocks as bad: mbadblocks. (line 6)
* mattrib: mattrib. (line 6) * mattrib: mattrib. (line 6)
* mbadblocks: mbadblocks. (line 6) * mbadblocks: mbadblocks. (line 6)
* mcat: mcat. (line 9) * mcat: mcat. (line 9)
* mcd: mcd. (line 6) * mcd: mcd. (line 6)
* mcd (introduction): directory. (line 6) * mcd (introduction): directory. (line 6)
* mclasserase: mclasserase. (line 6)
* mcopy: mcopy. (line 6) * mcopy: mcopy. (line 6)
* Mcwd file: mcd. (line 6) * Mcwd file: mcd. (line 6)
* mdel: mdel. (line 6) * mdel: mdel. (line 6)
* mdeltree: mdeltree. (line 6) * mdeltree: mdeltree. (line 6)
* mdir: mdir. (line 6) * mdir: mdir. (line 6)
* mdu: mdu. (line 6) * mdu: mdu. (line 6)
* Memory Card: mclasserase. (line 6)
* mformat: mformat. (line 6) * mformat: mformat. (line 6)
* mformat (geometry used for): geometry description. (line 6) * mformat (geometry used for): geometry description. (line 6)
* mformat parameters: minfo. (line 6) * mformat parameters: minfo. (line 6)
* minfo: minfo. (line 6) * minfo: minfo. (line 6)
* mkmanifest: mkmanifest. (line 6) * mkmanifest: mkmanifest. (line 6)
* mlabel: mlabel. (line 6) * mlabel: mlabel. (line 6)
* mmd: mmd. (line 6) * mmd: mmd. (line 6)
* mmount: mmount. (line 6) * mmount: mmount. (line 6)
* mmove: mmove. (line 6) * mmove: mmove. (line 6)
* Mounting a disk: mmount. (line 6) * Mounting a disk: mmount. (line 6)
skipping to change at line 2645 skipping to change at line 2622
* Options: arguments. (line 6) * Options: arguments. (line 6)
* OS/2 (layout of removable media): location information. (line 14) * OS/2 (layout of removable media): location information. (line 14)
* OS/2 (XDF disks): XDF. (line 6) * OS/2 (XDF disks): XDF. (line 6)
* Overwriting files: name clashes. (line 6) * Overwriting files: name clashes. (line 6)
* packing list: mkmanifest. (line 6) * packing list: mkmanifest. (line 6)
* Parsing order: parsing order. (line 6) * Parsing order: parsing order. (line 6)
* Partitioned image file: location information. (line 14) * Partitioned image file: location information. (line 14)
* partitions (creating): mpartition. (line 6) * partitions (creating): mpartition. (line 6)
* password protected Zip disks: mzip. (line 6) * password protected Zip disks: mzip. (line 6)
* patches: Location. (line 6) * patches: Location. (line 6)
* Physically erase: mclasserase. (line 6)
* plain floppy: device xxx busy: miscellaneous flags. (line 11) * plain floppy: device xxx busy: miscellaneous flags. (line 11)
* Porting: Porting mtools. (line 6) * Porting: Porting mtools. (line 6)
* Primary file name (long names): long names. (line 6) * Primary file name (long names): long names. (line 6)
* Primary file name (name clashes): name clashes. (line 6) * Primary file name (name clashes): name clashes. (line 6)
* Ram disk: location information. (line 28) * Ram disk: location information. (line 28)
* raw device: miscellaneous variables. * raw device: miscellaneous variables.
(line 60) (line 60)
* Read errors: mbadblocks. (line 6) * Read errors: mbadblocks. (line 6)
* Read-only files (changing the attribute): mattrib. (line 6) * Read-only files (changing the attribute): mattrib. (line 6)
* Read-only files (listing them): mdir. (line 6) * Read-only files (listing them): mdir. (line 6)
skipping to change at line 2724 skipping to change at line 2700
* XDF disks (compile time configuration): Compiling mtools. (line 6) * XDF disks (compile time configuration): Compiling mtools. (line 6)
* XDF disks (how to configure): miscellaneous flags. (line 70) * XDF disks (how to configure): miscellaneous flags. (line 70)
* Zip disk (utilities): mzip. (line 6) * Zip disk (utilities): mzip. (line 6)
* Zip disks (partitioning them): mpartition. (line 6) * Zip disks (partitioning them): mpartition. (line 6)
* Zip disks (partitions): location information. (line 14) * Zip disks (partitions): location information. (line 14)
* Zip disks (raw SCSI access): miscellaneous flags. (line 17) * Zip disks (raw SCSI access): miscellaneous flags. (line 17)
* ZipTools disk: mzip. (line 6) * ZipTools disk: mzip. (line 6)
 
Tag Table: Tag Table:
Node: Top872 Node: Top871
Node: Location3129 Node: Location3127
Node: Common features4067 Node: Common features4065
Node: arguments4831 Node: arguments4829
Node: drive letters6492 Node: drive letters6594
Node: directory7846 Node: directory7948
Node: long names8292 Node: long names8394
Node: name clashes10838 Node: name clashes10940
Node: case sensitivity13122 Node: case sensitivity13224
Node: high capacity formats14359 Node: high capacity formats14461
Node: more sectors15404 Node: more sectors15506
Node: bigger sectors16459 Node: bigger sectors16561
Node: 2m17188 Node: 2m17290
Node: XDF18374 Node: XDF18476
Node: exit codes19717 Node: exit codes19819
Node: bugs20355 Node: bugs20457
Node: Configuration20888 Node: Configuration20990
Node: configuration file location22177 Node: configuration file location22279
Node: general syntax22630 Node: general syntax22732
Node: default values23461 Node: default values23563
Node: global variables23989 Node: global variables24091
Node: per drive variables26182 Node: per drive variables26284
Node: general information27017 Node: general information27119
Node: location information27459 Node: location information27561
Node: geometry description28988 Node: geometry description29090
Node: open flags32849 Node: open flags32951
Node: miscellaneous variables33449 Node: miscellaneous variables33551
Node: miscellaneous flags37039 Node: miscellaneous flags37141
Node: multiple descriptions40669 Node: multiple descriptions40771
Node: parsing order42343 Node: parsing order42445
Node: old style configuration43374 Node: old style configuration43476
Node: Commands44073 Node: Commands44175
Node: floppyd45995 Node: floppyd46057
Node: floppyd_installtest50788 Node: floppyd_installtest50850
Node: mattrib51419 Node: mattrib51481
Node: mbadblocks53214 Node: mbadblocks53276
Node: mcat54508 Node: mcat54570
Node: mcd55322 Node: mcd55384
Node: mclasserase56183 Node: mcopy56239
Node: mcopy56859 Node: mdel59249
Node: mdel59877 Node: mdeltree59588
Node: mdeltree60216 Node: mdir60005
Node: mdir60635 Node: mdu61281
Node: mdu61911 Node: mformat61787
Node: mformat62417 Node: mkmanifest70298
Node: mkmanifest70928 Node: minfo72272
Node: minfo72902 Node: mlabel72842
Node: mlabel73472 Node: mmd73995
Node: mmd74625 Node: mmount74344
Node: mmount74974 Node: mmove74947
Node: mmove75577 Node: mpartition75752
Node: mpartition76382 Node: mrd81278
Node: mrd81908 Node: mren81636
Node: mren82266 Node: mshortname82385
Node: mshortname83015 Node: mshowfat82715
Node: mshowfat83345 Node: mtoolstest83124
Node: mtoolstest83754 Node: mtype83696
Node: mtype84326 Node: mzip84547
Node: mzip85177 Ref: mzip-Footnote-186572
Ref: mzip-Footnote-187202 Ref: mzip-Footnote-286653
Ref: mzip-Footnote-287283 Node: Compiling mtools86940
Node: Compiling mtools87570 Node: Porting mtools88039
Node: Porting mtools88669 Node: Command Index93947
Node: Command Index94577 Node: Variable Index94075
Node: Variable Index94705 Node: Concept Index95898
Node: Concept Index96528
 
End Tag Table End Tag Table
 
Local Variables: Local Variables:
coding: utf-8 coding: utf-8
End: End:
 End of changes. 37 change blocks. 
127 lines changed or deleted 102 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)