Imported Upstream version 4.0.35
[platform/upstream/mtools.git] / mtools.info
index 4dd81f8..3e6b80d 100644 (file)
@@ -1,6 +1,6 @@
 This is mtools.info, produced by makeinfo version 6.5 from mtools.texi.
 
-This manual is for Mtools (version 4.0.27, April 2021), which is a
+This manual is for Mtools (version 4.0.35, August 2021), which is a
 collection of tools to allow Unix systems to manipulate MS-DOS files.
 
    Copyright (C) 2007, 2009 Free Software Foundation, Inc.  Copyright
@@ -53,7 +53,7 @@ preliminary mounting or initialization (assuming the default
 '/etc/mtools.conf' works on your machine).  With mtools, one can change
 floppies too without unmounting and mounting.
 
-   This manual is for Mtools (version 4.0.27, April 2021), which is a
+   This manual is for Mtools (version 4.0.35, August 2021), which is a
 collection of tools to allow Unix systems to manipulate MS-DOS files.
 
    Copyright (C) 2007, 2009 Free Software Foundation, Inc.  Copyright
@@ -87,7 +87,7 @@ File: mtools.info,  Node: Location,  Next: Common features,  Prev: Top,  Up: Top
 *********************
 
 Mtools can be found at the following places (and their mirrors):
-     http://ftp.gnu.org/gnu/mtools/mtools-4.0.27.tar.gz
+     http://ftp.gnu.org/gnu/mtools/mtools-4.0.35.tar.gz
 
    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
@@ -848,6 +848,34 @@ integer (all others)
      specify a global code page for all drives by using the global
      'default_codepage' parameter (outside of any drive description).
      This parameters exists starting at version 4.0.0
+
+'data_map'
+     Remaps data from image file.  This is useful for image files which
+     might need additional zero-filled sectors to be inserted.  Such is
+     the case for instance for IBM 3174 floppy images.  These images
+     represent floppy disks with fewer sectors on their first cylinder.
+     These missing sectors are not stored in the image, but are still
+     counted in the filesystem layout.  The data_map allows to fake
+     these missing sectors for the upper layers of mtools.  A data_map
+     is a comma-separated sequence of source type and size.  Source type
+     may be 'zero' for zero-filled sectors created by map, 'skip' for
+     data in raw image to be ignored (skipped), and nothing for data to
+     be used as is (copied) from the raw image.  Datamap is
+     automatically complemented by an implicit last element of data to
+     be used as is from current offset to end of file.  Each size is a
+     number followed by a unit: 's' for a 512 byte sector, 'K' for
+     Kbytes, 'M' for megabytes, 'G' for gigabytes, and nothing for
+     single bytes.
+
+     Example:
+
+     'data_map=1s,zero31s,28s,skip1s' would be a map for use with IBM
+     3174 floppy images.  First sector ('1s', boot sector) is used as
+     is.  Then follow 31 fake zero-filled sectors ('zero31s'), then the
+     next 28 sectors from image ('28s') are used as is (they contain FAT
+     and root directory), then one sector from image is skipped
+     ('skip1s'), and finally the rest of image is used as is (implicit)
+
 'precmd'
      On some variants of Solaris, it is necessary to call 'volcheck -v'
      before opening a floppy device, in order for the system to notice
@@ -2454,12 +2482,12 @@ Concept index
 * Bad blocks:                            mbadblocks.           (line  6)
 * bigger sectors:                        bigger sectors.       (line  6)
 * blocksize:                             miscellaneous variables.
-                                                               (line 32)
+                                                               (line 60)
 * bugs:                                  Location.             (line  6)
 * Case sensitivity:                      case sensitivity.     (line  6)
 * Changing file attributes:              mattrib.              (line  6)
 * character devices:                     miscellaneous variables.
-                                                               (line 32)
+                                                               (line 60)
 * Checking configuration file:           mtoolstest.           (line  6)
 * Clusters of a file:                    mshowfat.             (line  6)
 * Command list:                          Commands.             (line  6)
@@ -2516,7 +2544,7 @@ Concept index
 * erasing MS-DOS files:                  mdel.                 (line  6)
 * exclusive access to a drive:           open flags.           (line  6)
 * Executing commands before opening the device: miscellaneous variables.
-                                                               (line 26)
+                                                               (line 54)
 * Fat:                                   mshowfat.             (line  6)
 * fdformat:                              more sectors.         (line  6)
 * File name of device node:              location information. (line 10)
@@ -2622,7 +2650,7 @@ Concept index
 * Primary file name (name clashes):      name clashes.         (line  6)
 * Ram disk:                              location information. (line 28)
 * raw device:                            miscellaneous variables.
-                                                               (line 32)
+                                                               (line 60)
 * Read errors:                           mbadblocks.           (line  6)
 * Read-only files (changing the attribute): mattrib.           (line  6)
 * Read-only files (listing them):        mdir.                 (line  6)
@@ -2648,7 +2676,7 @@ Concept index
 * Solaris (Raw access to SCSI devices such as Zip & Jaz): miscellaneous flags.
                                                                (line 17)
 * Solaris (volcheck):                    miscellaneous variables.
-                                                               (line 26)
+                                                               (line 54)
 * Solaris (vold):                        miscellaneous flags.  (line 57)
 * Space occupied by directories and files: mdu.                (line  6)
 * Special formats:                       high capacity formats.
@@ -2695,71 +2723,71 @@ Concept index
 
 \1f
 Tag Table:
-Node: Top\7f869
-Node: Location\7f3123
-Node: Common features\7f4061
-Node: arguments\7f4825
-Node: drive letters\7f6486
-Node: directory\7f7840
-Node: long names\7f8286
-Node: name clashes\7f10832
-Node: case sensitivity\7f13116
-Node: high capacity formats\7f14353
-Node: more sectors\7f15398
-Node: bigger sectors\7f16453
-Node: 2m\7f17182
-Node: XDF\7f18368
-Node: exit codes\7f19711
-Node: bugs\7f20349
-Node: Configuration\7f20882
-Node: configuration file location\7f22171
-Node: general syntax\7f22624
-Node: default values\7f23455
-Node: global variables\7f23983
-Node: per drive variables\7f26176
-Node: general information\7f27011
-Node: location information\7f27453
-Node: geometry description\7f28982
-Node: open flags\7f32843
-Node: miscellaneous variables\7f33443
-Node: miscellaneous flags\7f35519
-Node: multiple descriptions\7f39149
-Node: parsing order\7f40823
-Node: old style configuration\7f41854
-Node: Commands\7f42553
-Node: floppyd\7f44475
-Node: floppyd_installtest\7f49268
-Node: mattrib\7f49899
-Node: mbadblocks\7f51694
-Node: mcat\7f52988
-Node: mcd\7f53802
-Node: mclasserase\7f54663
-Node: mcopy\7f55339
-Node: mdel\7f58357
-Node: mdeltree\7f58696
-Node: mdir\7f59115
-Node: mdu\7f60391
-Node: mformat\7f60897
-Node: mkmanifest\7f69408
-Node: minfo\7f71382
-Node: mlabel\7f71952
-Node: mmd\7f73105
-Node: mmount\7f73454
-Node: mmove\7f74057
-Node: mpartition\7f74862
-Node: mrd\7f80388
-Node: mren\7f80746
-Node: mshortname\7f81495
-Node: mshowfat\7f81825
-Node: mtoolstest\7f82234
-Node: mtype\7f82806
-Node: mzip\7f83657
-Ref: mzip-Footnote-1\7f85682
-Ref: mzip-Footnote-2\7f85763
-Node: Compiling mtools\7f86050
-Node: Porting mtools\7f87149
-Node: Command Index\7f93057
-Node: Variable Index\7f93185
-Node: Concept Index\7f95008
+Node: Top\7f870
+Node: Location\7f3125
+Node: Common features\7f4063
+Node: arguments\7f4827
+Node: drive letters\7f6488
+Node: directory\7f7842
+Node: long names\7f8288
+Node: name clashes\7f10834
+Node: case sensitivity\7f13118
+Node: high capacity formats\7f14355
+Node: more sectors\7f15400
+Node: bigger sectors\7f16455
+Node: 2m\7f17184
+Node: XDF\7f18370
+Node: exit codes\7f19713
+Node: bugs\7f20351
+Node: Configuration\7f20884
+Node: configuration file location\7f22173
+Node: general syntax\7f22626
+Node: default values\7f23457
+Node: global variables\7f23985
+Node: per drive variables\7f26178
+Node: general information\7f27013
+Node: location information\7f27455
+Node: geometry description\7f28984
+Node: open flags\7f32845
+Node: miscellaneous variables\7f33445
+Node: miscellaneous flags\7f37035
+Node: multiple descriptions\7f40665
+Node: parsing order\7f42339
+Node: old style configuration\7f43370
+Node: Commands\7f44069
+Node: floppyd\7f45991
+Node: floppyd_installtest\7f50784
+Node: mattrib\7f51415
+Node: mbadblocks\7f53210
+Node: mcat\7f54504
+Node: mcd\7f55318
+Node: mclasserase\7f56179
+Node: mcopy\7f56855
+Node: mdel\7f59873
+Node: mdeltree\7f60212
+Node: mdir\7f60631
+Node: mdu\7f61907
+Node: mformat\7f62413
+Node: mkmanifest\7f70924
+Node: minfo\7f72898
+Node: mlabel\7f73468
+Node: mmd\7f74621
+Node: mmount\7f74970
+Node: mmove\7f75573
+Node: mpartition\7f76378
+Node: mrd\7f81904
+Node: mren\7f82262
+Node: mshortname\7f83011
+Node: mshowfat\7f83341
+Node: mtoolstest\7f83750
+Node: mtype\7f84322
+Node: mzip\7f85173
+Ref: mzip-Footnote-1\7f87198
+Ref: mzip-Footnote-2\7f87279
+Node: Compiling mtools\7f87566
+Node: Porting mtools\7f88665
+Node: Command Index\7f94573
+Node: Variable Index\7f94701
+Node: Concept Index\7f96524
 \1f
 End Tag Table