project/captive/man/mount.captive.pod.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3 <head>
   4 <title>mount.captive - B&lt;mount&gt; interface for NTFS disk access</title>
   5 <link rev="made" href="mailto:root@localhost" />
   6 </head>
   7
   8 <body style="background-color: white">
   9
  10 <p><a name="__index__"></a></p>
  11 <!-- INDEX BEGIN -->
  12
  13 <ul>
  14
  15         <li><a href="#name">NAME</a></li>
  16         <li><a href="#synopsis">SYNOPSIS</a></li>
  17         <li><a href="#description">DESCRIPTION</a></li>
  18         <li><a href="#options">OPTIONS</a></li>
  19         <li><a href="#see_also">SEE ALSO</a></li>
  20         <li><a href="#author">AUTHOR</a></li>
  21 </ul>
  22 <!-- INDEX END -->
  23
  24 <hr />
  25 <p>
  26 </p>
  27 <h1><a name="name">NAME</a></h1>
  28 <p>mount.captive - <strong>mount</strong>(8) interface for NTFS disk access</p>
  29 <p>
  30 </p>
  31 <hr />
  32 <h1><a name="synopsis">SYNOPSIS</a></h1>
  33 <p><strong>mount.captive-ntfs</strong> {<strong>image-file</strong>|<strong>device</strong>} <strong>mountdir</strong>
  34 [<strong>-n</strong>] [<strong>-v</strong>] [<strong>-o</strong> <strong>options</strong>]</p>
  35 <p><strong>mount</strong> <strong>-t</strong> <strong>captive-ntfs</strong>
  36 [<strong>-n</strong>] [<strong>-v</strong>] [<strong>-o</strong> <strong>options</strong>]
  37 {<strong>image-file</strong>|<strong>device</strong>} <strong>dir</strong></p>
  38 <p>
  39 </p>
  40 <hr />
  41 <h1><a name="description">DESCRIPTION</a></h1>
  42 <p><strong>mount.captive</strong>(8) provides <strong>mount</strong>(8) interface to <strong>lufs-captivefs</strong>(7)
  43 by calling <strong>lufsd</strong>(1) with appropriate arguments. You should never call
  44 this command directly - use <strong>mount</strong>(8) instead.</p>
  45 <p><strong>mount.captive</strong>(8) (<strong>captive</strong> filesystem type) is never used - this command
  46 is provided just as a base <code>mount(8)</code> interface to <strong>captive</strong>(7). You must always
  47 use captive-<strong>fstype</strong> filesystem type such as <strong>captive-ntfs</strong>. Other supported
  48 filesystem types are:
  49 <strong>ntfs</strong>, <strong>fastfat</strong>, <strong>cdfs</strong>, <strong>ext2fsd</strong></p>
  50 <p>
  51 </p>
  52 <hr />
  53 <h1><a name="options">OPTIONS</a></h1>
  54 <dl>
  55 <dt><strong><a name="item_%7bimage%2dfile%7cdevice%7d">{<strong>image-file</strong>|<strong>device</strong>}</a></strong><br />
  56 </dt>
  57 <dd>
  58 Pathname such as <strong>/dev/hda1</strong> or <strong>/tmp/ntfs.bin</strong>. You should refer to the
  59 partition name, not the whole device (<strong>/dev/hda</strong> is forbidden).
  60 <strong>/dev/hda1</strong> may correspond to <strong>/dev/ide/host0/bus0/target0/lun0/part1</strong>
  61 on your system.
  62 </dd>
  63 <p></p>
  64 <dt><strong><a name="item_mountdir"><strong>mountdir</strong></a></strong><br />
  65 </dt>
  66 <dd>
  67 Existing empty target directory where {<strong>image-file</strong>|<strong>device</strong>} will be
  68 mounted.
  69 </dd>
  70 <p></p>
  71 <dt><strong><a name="item_%2dn"><strong>-n</strong></a></strong><br />
  72 </dt>
  73 <dd>
  74 Do not modify <strong>/etc/mtab</strong>. This option is currently not supported (ignored),
  75 <strong>/etc/mtab</strong> is modified notwithstanding.
  76 </dd>
  77 <p></p>
  78 <dt><strong><a name="item_%2dv"><strong>-v</strong></a></strong><br />
  79 </dt>
  80 <dd>
  81 Enable verbose mode. Command <strong>lufsd</strong>(1) being called is shown.
  82 </dd>
  83 <p></p>
  84 <dt><strong><a name="item_%2do_options"><strong>-o</strong> <strong>options</strong></a></strong><br />
  85 </dt>
  86 <dd>
  87 Custom options passed to <strong>captive</strong>(7) separated by comma (<strong>,</strong>).
  88 See the <strong>captive</strong>(7) manpage for details on options prefixed by
  89 double-dashes (<strong>--</strong>) will be used for <strong>lufs-captivefs</strong>(7) /
  90 <strong>mount.captive</strong>(8). Options without double-dashes (<strong>--</strong>) will be used for
  91 <strong>lufsd</strong>(1). You may be interested in these unprefixed options:
  92 </dd>
  93 <dl>
  94 <dt><strong><a name="item_force"><strong>force</strong></a></strong><br />
  95 </dt>
  96 <dd>
  97 Force the mount of {<strong>image-file</strong>|<strong>device</strong>} despite it appears to be already
  98 mounted according to <strong>mtab</strong>(5). You should never mount a device multiple
  99 times in read-write mode. It is safe to mount it multiple times in read-only
 100 mode. It is safe to mount it once in read-write mode and multiple times
 101 in read-only mode although you may encounter filesystem errors by the read-only
 102 filesystems in such case.
 103 </dd>
 104 <dd>
 105 <p>This is the only option is interpreted by <strong>mount.captive</strong> itself; it is not
 106 <strong>lufs-captivefs</strong>(7) nor <strong>lufsd</strong>(1) option.</p>
 107 </dd>
 108 <p></p>
 109 <dt><strong><a name="item_private"><strong>private</strong></a></strong><br />
 110 </dt>
 111 <dd>
 112 <strong>mount.captive</strong>(8) defaults to filesystem files <strong>644</strong> - read-write for system
 113 root (or the regular user owner) and read-only for others. You can force the
 114 mode <strong>600</strong> by this option (read-write for the owner, inaccessible for others).
 115 Mode <strong>755</strong> or &lt;700&gt; applies to directories. Options <strong>fmask</strong>/<strong>dmask</strong> will
 116 be OR-ed to the private/public permissions set by this option.
 117 </dd>
 118 <p></p>
 119 <dt><strong><a name="item_fmask%3d666"><strong>fmask</strong>=<strong>666</strong></a></strong><br />
 120 </dt>
 121 <dd>
 122 Octal mask to be OR-ed on file permissions (minimum file permissions).
 123 </dd>
 124 <p></p>
 125 <dt><strong><a name="item_dmask%3d777"><strong>dmask</strong>=<strong>777</strong></a></strong><br />
 126 </dt>
 127 <dd>
 128 Octal mask to be OR-ed on directory permissions (minimum directory
 129 permissions).
 130 </dd>
 131 <p></p>
 132 <dt><strong><a name="item_uid%3d500"><strong>uid</strong>=<strong>500</strong></a></strong><br />
 133 </dt>
 134 <dd>
 135 Supply the <strong>UID</strong> to be the user identification number owning all the files.
 136 </dd>
 137 <p></p>
 138 <dt><strong><a name="item_gid%3d500"><strong>gid</strong>=<strong>500</strong></a></strong><br />
 139 </dt>
 140 <dd>
 141 Supply the <strong>GID</strong> to be the group identification number owning all the files.
 142 </dd>
 143 <p></p></dl>
 144 </dl>
 145 <p>
 146 </p>
 147 <hr />
 148 <h1><a name="see_also">SEE ALSO</a></h1>
 149 <p><strong>lufs-captivefs</strong>(7), <strong>lufsd</strong>(1)</p>
 150 <p>
 151 </p>
 152 <hr />
 153 <h1><a name="author">AUTHOR</a></h1>
 154 <p><table cellspacing="0" cellpadding="0"><tr><td>Jan Kratochvil &lt;<strong><a href="mailto:project-captive@jankratochvil.net">project-captive@jankratochvil.net</a></strong>&gt;,
 155 <tr><td><td><em><a href="http://www.jankratochvil.net/">http://www.jankratochvil.net/</a></em></table></p>
 156
 157 </body>
 158
 159 </html>