man/man1/mtools.1

   1 .TH MTOOLS 1
   2 .SH NAME
   3 mtools \- tools to access FAT file systems
   4 .SH SYNOPSIS
   5 .B mtools
   6 .RB [ \-V ]
   7 .B msdos_command
   8 .RI [ \-msdos_options ]
   9 .RI arguments " ..."
  10 .SH DESCRIPTION
  11 .de SP
  12 .if t .sp 0.4
  13 .if n .sp
  14 ..
  15 .B Mtools
  16 is a collection of utilities to access MS-DOS (FAT) disks from Unix without
  17 mounting them. It supports the long filenames of Windows NT and Windows 95.
  18 It does not support NTFS disks.
  19 .P
  20 Some versions of mtools for other operating systems provide separate
  21 commands, such as mdir, mcopy, etc., to emulate similar MS-DOS and Windows
  22 command line commands. The version ported to Minix takes the MS-DOS
  23 command (dir, copy, etc.) as its first argument. Supported MS-DOS
  24 commands are:
  25 .B attrib,
  26 .B badblocks,
  27 .B cat,
  28 .B cd,
  29 .B copy,
  30 .B del,
  31 .B deltree,
  32 .B dir,
  33 .B doctorfat,
  34 .B du,
  35 .B format,
  36 .B info,
  37 .B label,
  38 .B md,
  39 .B mkdir,
  40 .B partition,
  41 .B rd,
  42 .B rmdir,
  43 .B read,
  44 .B move,
  45 .B ren,
  46 .B showfat,
  47 .B type,
  48 .B write
  49 .P
  50 The MS-DOS options are the same as for DOS commands, except they are prefaced
  51 with "-" instead of "\\".
  52 .P
  53 Use 'mtools msdos_command -?' for help per command. (This tells you "-?"
  54 is an illegal command, but, as with Unix systems, entering an illegal command
  55 often is the easiest way to find out what are the legal commands.)
  56 .P
  57 Note that a disk argument must be terminate by or separated from a path by
  58 a colon (":").
  59 If no disk argument is given mtools assumes you meant "/dev/fd0:", the
  60 first floppy disk drive.
  61 .SH OPTIONS
  62 .TP
  63 .B \-V
  64 Show the mtools version and configuration
  65 .SH EXAMPLES
  66 .de EX
  67 .TP 20
  68 \\fB\\$1\\fR
  69 # \\$2
  70 ..
  71 .EX "mtools dir" "show directory of MS-DOS floppy in drive A:."
  72 .EX "mtools copy /dev/c0d0p0:file.txt ." "copy file.txt from MS-DOS root directory to current Minix directory."
  73 .SH "SEE ALSO"
  74 .BR dosdir (1).
  75 .BR dosread (1).
  76 .BR doswrite (1).
  77 .SH NOTES
  78 .P
  79 Mtools requires a lot of memory.  The default on a Minix 3 installation
  80 is over 10 MB.  A default configured mtools would not run on a system
  81 with only 16 MB RAM.  You may be able to make do by using chmem to
  82 reduce the memory allocation of mtools. On the 16 MB system mentioned
  83 mtools still works with a reduction of the memory allocation to half
  84 the original value.  The amount of memory you need depends upon the
  85 size of the MS-DOS or Windows file systems you want to access.
  86 Typically systems with big disks also have large amounts of memory.  If
  87 mtools won't work for you, you may be able to fall back to the old
  88 dosdir, dosread, and doswrite Minix utilities if the FAT file system
  89 you want to access is small enough (the dos* utilities can access FAT16
  90 partitions up to 256 MB size).
  91 .P
  92 This man page does not attempt to be complete. A lot of information is
  93 available on line. To use mtools well you also need to be familiar with
  94 the options for the corresponding MS-DOS commands.
  95 For more information see the mtools website, http://mtools.linux.lu/.
  96 .P
  97 Mtools-3.9.10 was released on 1 March 2005.  The Minix port is of the
  98 earlier Mtools version 3.9.7, dated 1 June 2000.
  99 .P
 100 The Minix port is configured with the following options: disable-xdf
 101 disable-vold disable-new-vold disable-debug disable-raw-term (read the source
 102 to understand what these mean).
 103 .SH BUGS
 104 Yes, bugs may exist, but as this man page is written we don't know of any.
 105 Please report any you find.
 106 .P
 107 As with any program that accesses a foreign file system, reading is probably
 108 safe, but you may want to experiment carefully before using these programs to
 109 write to a Windows system.
 110 .SH AUTHOR
 111 Mtools is maintained by David Niemi and Alain Knaff.
 112 .P
 113 Ported to Minix 2.0.3 by Kees J. Bot <kjb@cs.vu.nl>.
 114 .P
 115 This man page compiled by Al Woodhull <asw@woodhull.com>.
 116 .\" rev 2006-06-17