docs/lufs.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
   2 <HTML>
   3 <HEAD>
   4         <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
   5         <TITLE></TITLE>
   6         <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.0.1  (Linux)">
   7         <META NAME="CREATED" CONTENT="20020709;12384700">
   8         <META NAME="CHANGED" CONTENT="20030308;17343500">
   9         <STYLE>
  10         <!--
  11                 @page { margin-left: 2.01cm; margin-right: 2.01cm; margin-top: 2.54cm; margin-bottom: 2.54cm }
  12         -->
  13         </STYLE>
  14 </HEAD>
  15 <BODY LANG="en-US">
  16 <P ALIGN=CENTER STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=6>LUFS
  17 – Linux <SPAN LANG="en-US">Userland</SPAN> <SPAN LANG="en-US">File
  18 System</SPAN></FONT></FONT></P>
  19 <P ALIGN=CENTER STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=5>(sshfs,
  20 ftpfs, localfs, locasefs, gnutellafs, gvfs, cardfs, cefs)</FONT></FONT></P>
  21 <P ALIGN=CENTER STYLE="margin-bottom: 0cm"><BR>
  22 </P>
  23 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><U><B>1.
  24 INTRODUCTION</B></U></FONT></FONT></P>
  25 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
  26 </P>
  27 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  28 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>For those not interested
  29 in technicalities: </FONT></FONT>
  30 </P>
  31 <P ALIGN=JUSTIFY STYLE="margin-left: 2.01cm; margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  32 <BR>
  33 </P>
  34 <P ALIGN=JUSTIFY STYLE="margin-left: 2.01cm; margin-bottom: 0cm; text-decoration: none">
  35 <FONT FACE="Arial, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: medium">LUFS
  36 is enabling you to mount into your file hierarchy a remote computer's
  37 file system, which is accessible by various means (ftp, ssh, etc.).
  38 Then, the access to the remote files will be completely network
  39 transparent. In other words, you'll be able to read/modify remote
  40 files as if they were local, watch movies/listen to MP3s from
  41 FTP/SSH/Gnutella servers </SPAN><B>without</B><SPAN STYLE="font-weight: medium">
  42 copying them locally.<SPAN LANG="en-US"> Sheer </SPAN>magic. Now skip
  43 to the next section.</SPAN></FONT></FONT></P>
  44 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  45 <BR>
  46 </P>
  47 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  48 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>LUFS is a hybrid
  49 <SPAN LANG="en-US">userspace</SPAN> <SPAN LANG="en-US">file system</SPAN>
  50 framework supporting an indefinite number of <SPAN LANG="en-US">file
  51 systems</SPAN> transparently for any application. It consists of a
  52 kernel module and an userspace daemon. Basically it delegates most of
  53 the VFS calls to a specialized daemon which handles them.</FONT></FONT></P>
  54 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  55 <BR>
  56 </P>
  57 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  58 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The reason for the
  59 userspace stuff: there are operations only suited for userspace
  60 (cryptography  for example) and implementing them in kernel would be
  61 bloat.</FONT></FONT></P>
  62 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  63 <BR>
  64 </P>
  65 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  66 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The reason for the kernel
  67 stuff: I think it's important to keep the file system access point at
  68 the lowest level in order to allow all the applications to use it.
  69 Consider KDE: it implements its own virtual file system, a great one,
  70 but only KDE applications can take advantage of it. So does GNOME, MC
  71 and others. Suddenly we have lots of  overlapping userspace file
  72 system implementations, a real waste...</FONT></FONT></P>
  73 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  74 <BR>
  75 </P>
  76 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  77 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Communication between the
  78 kernel module and the daemon is done through UNIX domain sockets.
  79 This makes LUFS best suited for networked file systems, where this
  80 indirection overhead (userspace &lt;-&gt; kernel &lt;-&gt; userspace)
  81 is small compared to the speed penalty due to the network itself.</FONT></FONT></P>
  82 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  83 <BR>
  84 </P>
  85 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  86 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>LUFS can be regarded as
  87 doing the same job as the VFS (virtual file system switch) in the
  88 kernel: it is a switch, distributing the file system calls to its
  89 supported file systems. With a big difference: LUFS file systems are
  90 implemented in userspace. This would be a drawback for local file
  91 systems where the access speed is important, but proves to be a huge
  92 advantage for networked file systems where the <SPAN LANG="en-US">userland</SPAN>
  93 flexibility is most important.</FONT></FONT></P>
  94 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  95 <BR>
  96 </P>
  97 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
  98 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>This flexibility allowed
  99 for implementation of SSHFS for example, in a pretty straightforward
 100 manner, using the already existing <SPAN LANG="en-US">openssh</SPAN>
 101 infrastructure. Lots of other “exotic” file systems are in the
 102 planning phase: socketfs, httpfs, webdavfs, freenetfs, etc. Just
 103 imagine mounting a freenet file system and accessing all the goodies
 104 as they were local...</FONT></FONT></P>
 105 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 106 <BR>
 107 </P>
 108 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 109 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Everything is a file and
 110 if not, it should be!</FONT></FONT></P>
 111 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 112 <BR>
 113 </P>
 114 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; page-break-before: always">
 115 <FONT FACE="Arial, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><U><B>2.
 116 FILE SYSTEMS</B></U></FONT></FONT></P>
 117 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 118 </P>
 119 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 120 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>This section describes
 121 the file systems distributed with LUFS and provides some real mount
 122 examples. Other file systems might also be available.</FONT></FONT></P>
 123 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 124 <BR>
 125 </P>
 126 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 127 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The options presented
 128 here are file system specific, for a list of the global options
 129 please consult the <B>USAGE</B> section and the <B>lufsmount</B>(1)
 130 man page.</FONT></FONT></P>
 131 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 132 </P>
 133 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 134 </P>
 135 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 136 </P>
 137 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.1
 138 LOCALFS</B></FONT></FONT></P>
 139 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 140 </P>
 141 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 142 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>LocalFS is a proof of
 143 concept and didactic file system, meant to demonstrate the
 144 framework's power. All it does is mirror the local tree on the
 145 mountpoint. Consider it a tutorial ;)</FONT></FONT></P>
 146 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 147 <BR>
 148 </P>
 149 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 150 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>It is a complete (and
 151 inefficient for simplicity's sake) implementation.</FONT></FONT></P>
 152 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 153 <BR>
 154 </P>
 155 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><B>Specific
 156 mount options: </B><SPAN STYLE="font-weight: medium">none.</SPAN></FONT></FONT></SPAN></P>
 157 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 158 </P>
 159 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 160 example:</B></FONT></FONT></P>
 161 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 162 <BR>
 163 </P>
 164 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT FACE="Courier, monospace">[user@localhost]$<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none">
 165 lufsmount localfs:// ~/mnt/lufs -–uid=505</SPAN></SPAN></FONT></FONT></P>
 166 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 167 <BR>
 168 </P>
 169 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 170 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 171 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 172 <FONT FACE="Courier, monospace"><FONT SIZE=2>[root@localhost]# mount
 173 -t lufs none /mnt/lufs -o fs=localfs,uid=505</FONT></FONT></P>
 174 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 175 <BR>
 176 </P>
 177 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 178 <BR>
 179 </P>
 180 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 181 <BR>
 182 </P>
 183 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 184 <BR>
 185 </P>
 186 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.2
 187 LOCASEFS</B></FONT></FONT></P>
 188 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Contributed
 189 by:</B><SPAN STYLE="font-weight: medium"> Timothee Besset
 190 &lt;</SPAN><A HREF="mailto:ttimo@idsoftware.com"><SPAN STYLE="font-weight: medium">ttimo@idsoftware.com</SPAN></A><SPAN STYLE="font-weight: medium">&gt;</SPAN></FONT></FONT></P>
 191 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 192 <BR>
 193 </P>
 194 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 195 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>LoCaseFS provides a
 196 lowercase mapping of the local file system. It comes in handy when
 197 importing win32 source trees on *nix systems.</FONT></FONT></P>
 198 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 199 <BR>
 200 </P>
 201 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 202 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>It is a complete
 203 implementation (based on localfs, it could use some optimizations). </FONT></FONT>
 204 </P>
 205 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 206 </P>
 207 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 208 mount options:</B><SPAN STYLE="font-weight: medium"> none</SPAN></FONT></FONT></P>
 209 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 210 <BR>
 211 </P>
 212 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 213 example:</B></FONT></FONT></P>
 214 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 215 <BR>
 216 </P>
 217 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT FACE="Courier, monospace">[user@localhost]$<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none">
 218 lufsmount locasefs:// ~/mnt/lufs -–uid=505</SPAN></SPAN></FONT></FONT></P>
 219 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 220 <BR>
 221 </P>
 222 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 223 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 224 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 225 <FONT FACE="Courier, monospace"><FONT SIZE=2>[root@localhost]# mount
 226 -t lufs none /mnt/lufs -o fs=locasefs,uid=505</FONT></FONT></P>
 227 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 228 <BR>
 229 </P>
 230 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 231 <BR>
 232 </P>
 233 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 234 <BR>
 235 </P>
 236 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 237 <BR>
 238 </P>
 239 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.3
 240 SSHFS</B></FONT></FONT></P>
 241 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Requires:
 242 </B><SPAN STYLE="font-weight: medium">ssh ( </SPAN><A HREF="http://www.openssh.org/"><SPAN STYLE="font-weight: medium">http://www.openssh.org
 243 </SPAN></A><SPAN STYLE="font-weight: medium">).</SPAN></FONT></FONT></P>
 244 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 245 </P>
 246 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 247 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>SshFS is probably the
 248 most advanced LUFS file system because of its security, usefulness
 249 and completeness. It is based on the SFTP protocol and requires
 250 openssh. You can mount remote file systems accessible through sftp
 251 (scp utility).</FONT></FONT></P>
 252 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 253 <BR>
 254 </P>
 255 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 256 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>It is a complete
 257 implementation. </FONT></FONT>
 258 </P>
 259 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 260 </P>
 261 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 262 </P>
 263 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 264 mount options:</B></FONT></FONT></P>
 265 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 266 <BR>
 267 </P>
 268 <UL>
 269         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 270         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>host=<B>server</B>  : the
 271         sftp server to mount (authentication should be properly configured,
 272         see below)</FONT></FONT></P>
 273         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">port=</SPAN><B>port</B><SPAN STYLE="font-weight: medium">     :
 274         the port the sftp server is listening on</SPAN></FONT></FONT></SPAN></P>
 275         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 276         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>username=<B>user</B>        :
 277         the user to authenticate on the server (see INSTALLATION)</FONT></FONT></P>
 278 </UL>
 279 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 280 <BR>
 281 </P>
 282 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 283 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>I recommend setting up
 284 public key authentication (DSA or RSA based) on the remote system for
 285 the mounting user when using sshfs. This will allow the daemon to
 286 open several channels without any user interaction. Consult the
 287 ssh(1) manual page or try the<B> lussh</B> script<B> </B>for ssh
 288 setup.</FONT></FONT></P>
 289 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 290 <BR>
 291 </P>
 292 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>lussh</B><SPAN STYLE="font-weight: medium">
 293 is a helper script which tries to automatically setup public key
 294 authentication for ssh. You will be prompted for the ssh server and
 295 the remote username by the script and for the remote user's password
 296 by openssh. If you are prompted for the password more that twice,
 297 then public key authentication setup failed for the given
 298 server/user.</SPAN></FONT></FONT></P>
 299 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 300 <BR>
 301 </P>
 302 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">It
 303 is possible to use sshfs without a public key authentication setup
 304 (provided you have openssh-askpass-gnome or some other ssh
 305 authentication helper) but you will be asked for passwords
 306 interactively. If this is annoying, you can reduce the number of
 307 communication channels (</SPAN><B>channels=1</B><SPAN STYLE="font-weight: medium">
 308 option).</SPAN></FONT></FONT></SPAN></P>
 309 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 310 <BR>
 311 </P>
 312 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 313 example:</B></FONT></FONT></P>
 314 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 315 <BR>
 316 </P>
 317 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 318 <FONT FACE="Courier, monospace"><FONT SIZE=2>[user@localhost]$
 319 lufsmount sshfs://mali@lufs.sourceforge.net ~/mnt/lufs –-fmask=444
 320 -–dmask=555</FONT></FONT></P>
 321 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 322 <BR>
 323 </P>
 324 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 325 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 326 <P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT FACE="Courier, monospace"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none">[</SPAN></SPAN>root@localhost<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none">]#
 327 mount -t lufs none /mnt/lufs -o
 328 nosuid,fs=sshfs,host=</SPAN></SPAN>lufs.sourceforge.net<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none">,username=mali,fmode=444,dmode=555</SPAN></SPAN></FONT></FONT></P>
 329 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 330 </P>
 331 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 332 </P>
 333 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 334 </P>
 335 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.4
 336 FTPFS</B></FONT></FONT></P>
 337 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 338 <BR>
 339 </P>
 340 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 341 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>FtpFS is a port of an old
 342 kernel implementation ( <A HREF="http://ftpfs.sourceforge.net/">http://ftpfs.sourceforge.net
 343 </A>). Based on  FTP, this file system  allows you to mount ftp sites
 344 locally.</FONT></FONT></P>
 345 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 346 <BR>
 347 </P>
 348 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 349 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Because of FTP's nature,
 350 there are some limitations: </FONT></FONT>
 351 </P>
 352 <UL>
 353         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 354         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>the communication is in
 355         clear</FONT></FONT></P>
 356         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 357         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>some operations are not
 358         supported by the protocol</FONT></FONT></P>
 359         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 360         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>some operations are not
 361         supported by specific server implementations</FONT></FONT></P>
 362 </UL>
 363 <P ALIGN=JUSTIFY STYLE="margin-left: 2.2cm; margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 364 <BR>
 365 </P>
 366 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 367 mount options:</B></FONT></FONT></P>
 368 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 369 <BR>
 370 </P>
 371 <UL>
 372         <LI><P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif">host=<B>server</B><SPAN STYLE="font-weight: medium">   :
 373         the ftp server to mount</SPAN></FONT></P>
 374         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Arial, sans-serif">port=<B>port</B>  :
 375         the port the ftp server is listening on</FONT></P>
 376         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Arial, sans-serif">username=<B>user</B>      :
 377         the user to authenticate on the server</FONT></P>
 378         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Arial, sans-serif">password=<B>pass</B>      :
 379         the user's password</FONT></P>
 380         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Arial, sans-serif">ftpactive         :
 381         will use active data connection (the server initiates the data
 382         connection) instead of passive data connection (the client opens the
 383         connection)</FONT></P>
 384 </UL>
 385 <P STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 386 </P>
 387 <P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">If
 388 no username is supplied, LUFS will try </SPAN><B>anonymous</B><SPAN STYLE="font-weight: medium">
 389 access.</SPAN></FONT></P>
 390 <P STYLE="margin-bottom: 0cm"><SPAN STYLE="font-weight: medium"><FONT FACE="Arial, sans-serif">If
 391 the ftp server only allows a limited number of logins from a certain
 392 IP (1 per IP), you should limit the number of channels with the
 393 </FONT><FONT FACE="Courier, monospace">channels</FONT><FONT FACE="Arial, sans-serif">
 394 option ( </FONT><FONT FACE="Courier, monospace">channels=1</FONT><FONT FACE="Arial, sans-serif">
 395 ).</FONT></SPAN></P>
 396 <P STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 397 </P>
 398 <P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>Mount
 399 example:</B></FONT></P>
 400 <P STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 401 </P>
 402 <P STYLE="margin-bottom: 0cm"><FONT FACE="Courier, monospace"><FONT SIZE=2><SPAN STYLE="font-weight: medium">[user@localhost]$<SPAN STYLE="text-decoration: none">
 403 lufsmount ftpfs:</SPAN></SPAN>//mali:<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none">mypass@ftp.sourceforge.net
 404 ~/mnt/lufs -o ftpactive</SPAN></SPAN></FONT></FONT></P>
 405 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 406 <BR>
 407 </P>
 408 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 409 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 410 <P STYLE="margin-bottom: 0cm"><FONT SIZE=2><FONT FACE="Courier, monospace"><SPAN STYLE="font-weight: medium">[</SPAN>root@localhost<SPAN STYLE="font-weight: medium">]#
 411 mount -t lufs none /mnt/lufs -o
 412 nosuid,fs=ftpfs,host=</SPAN>ftp.sourceforge.net<SPAN STYLE="font-weight: medium">,username=mali,password=mypass,ftpactive</SPAN></FONT></FONT></P>
 413 <P STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
 414 </P>
 415 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 416 <BR>
 417 </P>
 418 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 419 </P>
 420 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.5
 421 GNUTELLAFS (GNETFS)</B></FONT></FONT></P>
 422 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 423 <BR>
 424 </P>
 425 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif">OK,
 426 it's time to fasten your seatbelt and hold your breath: Kansas is
 427 going bye-bye 'cause you're about to swallow the red pill</FONT></FONT></SPAN></SPAN>.</P>
 428 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 429 <BR>
 430 </P>
 431 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 432 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Forget everything you
 433 knew about file sharing clients. This is a glimpse of the future...</FONT></FONT></P>
 434 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 435 <BR>
 436 </P>
 437 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 438 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>You mount a gnetfs in
 439 ~/gnet. You wait a couple of minutes so it can establish its peer
 440 connections. You start a search by creating a subdirectory of SEARCH:
 441 mkdir “~/gnet/SEARCH/metallica mp3”. You wait a few seconds for
 442 the results to accumulate. The you chdir to “SEARCH/metallica mp3”
 443 and try a ls: surprise – the files are there! You shoot up mpg123
 444 and enjoy... You are happy.</FONT></FONT></P>
 445 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 446 <BR>
 447 </P>
 448 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 449 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Sounds too good to be
 450 true? Well, it's here... </FONT></FONT>
 451 </P>
 452 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 453 <BR>
 454 </P>
 455 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 456 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>GnetFS is a Gnutella
 457 network interface. You can perform searches and access resources
 458 without downloading them locally.</FONT></FONT></P>
 459 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 460 <BR>
 461 </P>
 462 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 463 options:</B></FONT></FONT></P>
 464 <UL>
 465         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 466         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>known_peers=<B>MAX          </B>:
 467         maximum number of known peers (see below)</FONT></FONT></P>
 468         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">hostX=</SPAN><B>IP:port</B><SPAN STYLE="font-weight: medium">         :
 469         known peer – specify initial peers (X &lt; </SPAN><B>MAX</B><SPAN STYLE="font-weight: medium">)</SPAN></FONT></FONT></SPAN></P>
 470 </UL>
 471 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 472 <BR>
 473 </P>
 474 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 475 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>All these have sane
 476 defaults in <FONT FACE="Courier, monospace">/etc/lufsd.conf</FONT> so
 477 you can just ignore them. Just make sure you specify a small
 478 dir_cache_ttl so that the directory cache won't get in your way (the
 479 gnutella results are cached anyway).</FONT></FONT></P>
 480 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 481 <BR>
 482 </P>
 483 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 484 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>In order to start a
 485 search you create a subdirectory of <B>SEARCH</B>. A search for the
 486 text in subdirectory's name will be started in background and results
 487 added to that dir gradually. Once you have some results, you can
 488 start accessing (read-only) them. When you are no longer interested
 489 in that search, you simply erase the directory.</FONT></FONT></P>
 490 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 491 <BR>
 492 </P>
 493 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Note</B><SPAN STYLE="font-weight: medium">:
 494 You need some serious bandwidth in order to enjoy gnetfs. LAN is
 495 great, DSL will do. Maybe cable too.</SPAN></FONT></FONT></P>
 496 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 497 <BR>
 498 </P>
 499 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>IMPORTANT:
 500 gnetfs is EXPERIMENTAL! At least the searches seem to be working OK
 501 while for transfers you need to be lucky (but this is no news to
 502 gnutella users, is it?:) . The gnutella back-end is incomplete and
 503 only implements the bare basics needed for file searching/download –
 504 no uploads/sharing (the gnutella guys are probably out to get me as I
 505 write :). Hope this will change soon, I'm stuck with a dialup
 506 connection for now so I'm counting a LOT on your feedback.</B></FONT></FONT></P>
 507 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 508 <BR>
 509 </P>
 510 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 511 examples:</B></FONT></FONT></P>
 512 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 513 <BR>
 514 </P>
 515 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 516 <FONT FACE="Courier, monospace"><FONT SIZE=2>[user@localhost]$
 517 lufsmount gnetfs:// ~/gnet -o dir_cache_ttl=1</FONT></FONT></P>
 518 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 519 <BR>
 520 </P>
 521 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 522 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 523 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 524 </P>
 525 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 526 <FONT FACE="Courier, monospace"><FONT SIZE=2>[user@localhost]# mount
 527 -t lufs none /mnt/gnet -o fs=gnetfs,dir_cache_ttl=1</FONT></FONT></P>
 528 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 529 <BR>
 530 </P>
 531 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 532 <BR>
 533 </P>
 534 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 535 <BR>
 536 </P>
 537 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.6
 538 GVFS (GnomeVFS)</B></FONT></FONT></P>
 539 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Requires:
 540 </B><SPAN STYLE="font-weight: medium">Gnome, libnomevfs
 541 (</SPAN><A HREF="http://www.gnome.org/"><SPAN STYLE="font-weight: medium">http://www.gnome.org</SPAN></A><SPAN STYLE="font-weight: medium">)</SPAN></FONT></FONT></P>
 542 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 543 <BR>
 544 </P>
 545 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 546 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>GVFS is an adapter file
 547 system linking lufs to Gnome's vfs. Thus, you gain access to the vfs
 548 functionality implemented in Gnome from all the applications. While
 549 not a very bright idea in itself (I think Gnome should use lufs or a
 550 similar concept) this might add some value to lufs considering the
 551 number of existing Gnome vfs modules.</FONT></FONT></P>
 552 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 553 <BR>
 554 </P>
 555 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 556 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The functionality is
 557 dependent on that of the used Gnome VFS module, which (for gnomevfs-1
 558 at least) isn't exactly impressive. The ftp and ssh modules
 559 especially, don't even come close to their lufs native corespondents.</FONT></FONT></P>
 560 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 561 <BR>
 562 </P>
 563 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 564 mount options:</B></FONT></FONT></P>
 565 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 566 <BR>
 567 </P>
 568 <P STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">No
 569 specific options, but the </SPAN><B>root</B><SPAN STYLE="font-weight: medium">
 570 option is mandatory and has a special meaning: it specifies the Gnome
 571 VFS URI to mount (thus it includes the protocol, host and all the
 572 other meaningful components) preceded by a “/” (example:
 573 </SPAN></FONT><FONT FACE="Courier, monospace"><B>root</B><SPAN STYLE="font-weight: medium">=/smb://station2</SPAN></FONT><SPAN STYLE="font-weight: medium"><FONT FACE="Arial, sans-serif">).</FONT></SPAN></FONT></SPAN></P>
 574 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 575 <BR>
 576 </P>
 577 <P STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 578 examples:</B></FONT></FONT></P>
 579 <P STYLE="margin-bottom: 0cm"><FONT SIZE=2><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">[user@localhost]$
 580 lufsmount gvfs:</FONT></SPAN></SPAN><FONT FACE="Courier, monospace">///ssh</FONT><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">://mali@ssh.sf.net
 581 ~/mnt/lufs</FONT></SPAN></SPAN></FONT></P>
 582 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 583 <BR>
 584 </P>
 585 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 586 <FONT FACE="Courier, monospace"><FONT SIZE=2>[user@localhost]$
 587 lufsmount gvfs:///file:/ ~/mnt/lufs</FONT></FONT></P>
 588 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 589 <BR>
 590 </P>
 591 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 592 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 593 <P STYLE="margin-bottom: 0cm"><FONT FACE="Courier, monospace"><FONT SIZE=2>[root@localhost]#
 594 mount -t lufs none /mnt/lufs -o
 595 fs=gvfs,root=/ftp://mali:xxxxx@ftp.sf.net</FONT></FONT></P>
 596 <P STYLE="margin-bottom: 0cm"><BR>
 597 </P>
 598 <P STYLE="margin-bottom: 0cm"><FONT FACE="Courier, monospace"><FONT SIZE=2>[root@localhost]#
 599 mount -t lufs none /mnt/lufs -o fs=gvfs,root=/start-here:/</FONT></FONT></P>
 600 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 601 <BR>
 602 </P>
 603 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 604 </P>
 605 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 606 </P>
 607 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.7
 608 CARDFS</B></FONT></FONT></P>
 609 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><B>Contributed
 610 by: </B><SPAN STYLE="font-weight: medium">Martin Preuss &lt;
 611 </SPAN></FONT></FONT></SPAN><A HREF="mailto:preuss@hamburg.de"><SPAN STYLE="font-weight: medium"><U><FONT SIZE=3><FONT FACE="Arial, sans-serif">m_preuss@hamburg.de
 612  </FONT></FONT></U></SPAN></A><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif">&gt;.</FONT></FONT></SPAN></SPAN></P>
 613 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Requires:
 614 </B><SPAN STYLE="font-weight: medium">libchipcard (
 615 </SPAN><A HREF="http://www.libchipcard.de/"><SPAN STYLE="font-weight: medium">http://www.libchipcard.de</SPAN></A><SPAN STYLE="font-weight: medium">
 616 ).</SPAN></FONT></FONT></P>
 617 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 618 <BR>
 619 </P>
 620 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 621 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>This module allows you to
 622 mount memory card file systems. It requires the latest CVS
 623 libchipcard version.</FONT></FONT></P>
 624 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 625 <BR>
 626 </P>
 627 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 628 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>You must enable cefs
 629 support at configure time, using  --<FONT FACE="Courier, monospace">enable-cardfs</FONT>
 630 if you want this file system to be built.</FONT></FONT></P>
 631 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 632 <BR>
 633 </P>
 634 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 635 mount options:</B></FONT></FONT></P>
 636 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 637 <BR>
 638 </P>
 639 <UL>
 640         <LI><P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3>host=</FONT></SPAN></SPAN><B><SPAN STYLE="font-style: normal">teminal@address</SPAN></B><SPAN STYLE="text-decoration: none"><FONT SIZE=3><SPAN STYLE="font-weight: medium"> :
 641         terminal is the short name of your terminal (</SPAN><B>tow1</B><SPAN STYLE="font-weight: medium">,</SPAN></FONT></SPAN></FONT></P>
 642 </UL>
 643 <P STYLE="margin-left: 6.87cm; margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><B>pcsc0
 644 </B><SPAN STYLE="font-weight: medium">or whatever name you assigned
 645 to your terminal). If omitted the default terminal will be used.</SPAN></FONT></FONT></SPAN></P>
 646 <P STYLE="margin-left: 6.84cm; margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 647 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>address is the address
 648 the cardfs daemon listens on (cardfsd's -a option)</FONT></FONT></P>
 649 <UL>
 650         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 651         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>port=<B>port</B>            : the
 652         port that cardfsd is listening on (-p option)</FONT></FONT></P>
 653         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 654         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>username=<B>user    </B>    :
 655         the name used to authorize yourself to the card (only needed if
 656         encryption is enabled on the card)</FONT></FONT></P>
 657         <LI><P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 658         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>password=<B>pass    </B>    :
 659         the password used for encryption/decryption</FONT></FONT></P>
 660 </UL>
 661 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 662 <BR>
 663 </P>
 664 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 665 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>You must start
 666 libchipcard's cardfs daemon before mounting the file system:</FONT></FONT></P>
 667 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 668 <FONT FACE="Courier, monospace"><FONT SIZE=2>[root@localhost]#
 669 cardfsd -a ADDRESS_TO_BIND_TO -p PORT_TO_BIND_TO</FONT></FONT></P>
 670 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 671 <BR>
 672 </P>
 673 <P STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 674 example:</B></FONT></FONT></P>
 675 <P STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
 676 </P>
 677 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT SIZE=2><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">[root@localhost]#
 678 lufsmount cardfs:</FONT></SPAN></SPAN><FONT FACE="Courier, monospace">//myusr</FONT><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">:password@ttyS0@127.0.0.1:9770
 679 /mnt/lufs</FONT></SPAN></SPAN></FONT></P>
 680 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 681 <BR>
 682 </P>
 683 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 684 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 685 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT SIZE=2><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">[root@localhost]#
 686 mount -t lufs none /mnt/lufs -o
 687 nosuid,fs=cardfs,username=myusr,password=mypass,host=</FONT></SPAN></SPAN><FONT FACE="Courier, monospace">ttyS0@127.0.0.1</FONT><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">,port=9770</FONT></SPAN></SPAN></FONT></P>
 688 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 689 <BR>
 690 </P>
 691 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 692 <BR>
 693 </P>
 694 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 695 <BR>
 696 </P>
 697 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=4><B>2.8
 698 CEFS</B></FONT></FONT></P>
 699 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Contributed
 700 by:</B><SPAN STYLE="font-weight: medium"> Fedor Bezrukov &lt;
 701 </SPAN><A HREF="mailto:fedor@ms2.inr.ac.ru"><SPAN STYLE="font-weight: medium">fedor@ms2.inr.ac.ru</SPAN></A><A HREF="fedor@ms2.inr.ac.ru"><SPAN STYLE="font-weight: medium">
 702 </SPAN></A><SPAN STYLE="font-weight: medium">&gt;</SPAN></FONT></FONT></P>
 703 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 704 <BR>
 705 </P>
 706 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 707 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>This lufs module allows
 708 access to a CE device's (HP (Compaq) IPAQ, HP Jornada, etc...) file
 709 system.</FONT></FONT></P>
 710 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 711 <BR>
 712 </P>
 713 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif">You
 714 must enable cefs support at configure time, using  --</FONT><FONT FACE="Courier, monospace">enable-cefs</FONT><FONT FACE="Arial, sans-serif">
 715 if you want this file system to be built.</FONT></FONT></SPAN></SPAN></P>
 716 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 717 <BR>
 718 </P>
 719 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Specific
 720 mount options:</B></FONT></FONT></P>
 721 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 722 <BR>
 723 </P>
 724 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 725 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>No specific options here.
 726 Simply mount the file system after connecting your PDA.</FONT></FONT></P>
 727 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 728 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Check out <FONT FACE="Courier, monospace">cefs.txt</FONT>
 729 for detailed information.</FONT></FONT></P>
 730 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 731 <BR>
 732 </P>
 733 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Mount
 734 example:</B></FONT></FONT></P>
 735 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 736 <BR>
 737 </P>
 738 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 739 <FONT FACE="Courier, monospace"><FONT SIZE=2>[user@localhost]$
 740 lufsmount cefs:// ~/mnt/lufs</FONT></FONT></P>
 741 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 742 <BR>
 743 </P>
 744 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 745 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>or, using mount:</FONT></FONT></P>
 746 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 747 <FONT FACE="Courier, monospace"><FONT SIZE=2>[root@localhost]# mount
 748 -t lufs none /mnt/lufs -o nosuid,fs=cefs</FONT></FONT></P>
 749 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 750 <BR>
 751 </P>
 752 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; page-break-before: always">
 753 <FONT FACE="Arial, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><U><B>3.
 754 BUILD &amp; INSTALLATION</B></U></FONT></FONT></P>
 755 <OL START=3>
 756         <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"></P>
 757 </OL>
 758 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><SPAN STYLE="font-weight: medium"><FONT SIZE=4><FONT FACE="Arial, sans-serif">3.1
 759 SOURCE DISTRIBUTION</FONT></FONT></SPAN></P>
 760 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 761 </P>
 762 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 763 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>In order to build LUFS
 764 you need to have the running kernel's headers installed. Check
 765 whether <FONT FACE="Courier, monospace">/lib/modules/`uname
 766 -r`/build/include </FONT>is pointing to the running kernel's include
 767 dir.</FONT></FONT></P>
 768 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 769 <BR>
 770 </P>
 771 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>IMPORTANT:</B></FONT></FONT></P>
 772 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 773 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The kernel module
 774 requires the same compiler that was used for your running kernel's
 775 build. </FONT></FONT>
 776 </P>
 777 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 778 <BR>
 779 </P>
 780 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 781 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Executing </FONT></FONT>
 782 </P>
 783 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 784 <BR>
 785 </P>
 786 <P STYLE="margin-left: 0.48cm; margin-bottom: 0cm"><FONT FACE="Courier, monospace"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3>[</FONT></SPAN></SPAN>root@localhost<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3>]#
 787 ./configure [options]</FONT></SPAN></SPAN></FONT></P>
 788 <P STYLE="margin-left: 0.48cm; margin-bottom: 0cm"><FONT FACE="Courier, monospace"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3>[</FONT></SPAN></SPAN>root@localhost<SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3>]#
 789 make</FONT></SPAN></SPAN></FONT></P>
 790 <P STYLE="margin-left: 0.48cm; margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 791 <FONT FACE="Courier, monospace"><FONT SIZE=3>[root@localhost]# make
 792 install</FONT></FONT></P>
 793 <P ALIGN=JUSTIFY STYLE="margin-left: 0.48cm; margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 794 <BR>
 795 </P>
 796 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 797 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>as root in the top lufs
 798 directory should build and install the application. </FONT></FONT>
 799 </P>
 800 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 801 </P>
 802 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif">The
 803 non-standard configure options are:</FONT></P>
 804 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 805 </P>
 806 <UL>
 807         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--with-kernel=VERSION</B><SPAN STYLE="font-weight: medium">   configure
 808         for the specified kernel version (skip</SPAN></FONT></P>
 809 </UL>
 810 <P ALIGN=JUSTIFY STYLE="margin-left: 6.65cm; margin-bottom: 0cm; font-weight: medium">
 811 <FONT FACE="Arial, sans-serif">auto-detection)</FONT></P>
 812 <UL>
 813         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--with-kheaders=DIR</B><SPAN STYLE="font-weight: medium">     specify
 814         the location of the kernel headers (skip</SPAN></FONT></P>
 815 </UL>
 816 <P ALIGN=JUSTIFY STYLE="margin-left: 6.65cm; margin-bottom: 0cm; font-weight: medium">
 817 <FONT FACE="Arial, sans-serif">auto-detection)</FONT></P>
 818 <UL>
 819         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--with-ssh=SSH</B><SPAN STYLE="font-weight: medium">          specify
 820         the location of the ssh executable</SPAN></FONT></P>
 821         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--enable-debug</B><SPAN STYLE="font-weight: medium">          enable
 822         debug messages from the daemon</SPAN></FONT></P>
 823         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--enable-kdebug</B><SPAN STYLE="font-weight: medium">         enable
 824         debug messages from the kernel module</SPAN></FONT></P>
 825         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--enable-cardfs</B><SPAN STYLE="font-weight: medium">         enable
 826         cardfs support</SPAN></FONT></P>
 827         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--enable-cefs</B><SPAN STYLE="font-weight: medium">           enable
 828         cefs support</SPAN></FONT></P>
 829         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--enable-autofs-install</B><SPAN STYLE="font-weight: medium"> enable
 830         installing of autofs config file</SPAN></FONT></P>
 831         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--enable-modversions</B><SPAN STYLE="font-weight: medium">    force
 832         modversions kernel support</SPAN></FONT></P>
 833         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>--disable-suid</B><SPAN STYLE="font-weight: medium">          lufsmnt
 834         and lufsumount will not be made suid (regular </SPAN></FONT>
 835         </P>
 836 </UL>
 837 <P ALIGN=JUSTIFY STYLE="margin-left: 6.61cm; margin-bottom: 0cm; font-weight: medium">
 838 <FONT FACE="Arial, sans-serif">users won't be able to mount lufs).</FONT></P>
 839 <UL>
 840         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><B>--disable-kernel-support</B><SPAN STYLE="font-weight: medium">       do
 841         not build &amp; install the required kernel module</SPAN></FONT></FONT></SPAN></P>
 842         <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 843         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>(useful when your kernel
 844         is already patched for lufs support) </FONT></FONT>
 845         </P>
 846 </UL>
 847 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 848 <BR>
 849 </P>
 850 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 851 <BR>
 852 </P>
 853 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 854 <BR>
 855 </P>
 856 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 857 <FONT FACE="Arial, sans-serif"><FONT SIZE=4>3.2 PATCHED KERNEL</FONT></FONT></P>
 858 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 859 <BR>
 860 </P>
 861 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 862 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>If for some reason (read
 863 <B>modversions</B>:) the kernel module fails to compile and install
 864 properly, you can try to patch the kernel manually.</FONT></FONT></P>
 865 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 866 <BR>
 867 </P>
 868 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 869 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Download the patch for
 870 your kernel version (if available) into your kernel's source top
 871 directory. Apply it by</FONT></FONT></P>
 872 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 873 <BR>
 874 </P>
 875 <P STYLE="margin-bottom: 0cm"><FONT SIZE=2><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">[</FONT></SPAN></SPAN><FONT FACE="Courier, monospace">user@localhost</FONT><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">
 876 ~/linux-2.4.19]$ zcat </FONT></SPAN></SPAN><FONT FACE="Courier, monospace">lufs-x.x.x-x.x.x.patch.gz</FONT><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT FACE="Courier, monospace">
 877 | patch -Np1</FONT></SPAN></SPAN></FONT></P>
 878 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 879 <BR>
 880 </P>
 881 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 882 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Then proceed with
 883 building and installing your kernel, not forgetting to reconfigure
 884 it, enabling LUFS under FILE SYSTEMS section first (it requires
 885 development/incomplete drivers and UNIX domain sockets).</FONT></FONT></P>
 886 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 887 <BR>
 888 </P>
 889 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 890 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The rest of the package
 891 can then be easily installed as described above, specifying
 892 –<B>disable-kernel-support</B> when running ./configure.</FONT></FONT></P>
 893 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 894 <BR>
 895 </P>
 896 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 897 <BR>
 898 </P>
 899 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 900 <BR>
 901 </P>
 902 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 903 <FONT FACE="Arial, sans-serif"><FONT SIZE=4>3.3 DEBUG BUILD</FONT></FONT></P>
 904 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 905 <BR>
 906 </P>
 907 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 908 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>So you've got lufs
 909 installed but bumped right into that nasty buggy... The cruel
 910 realization of lufs' imperfection<SPAN LANG="en-US"> overwhelms
 911 you... But wait, maybe you can do something about it!</SPAN></FONT></FONT></P>
 912 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 913 <BR>
 914 </P>
 915 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 916 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Don't  worry, I'm not
 917 gonna tell you to shoot gdb up and start hacking. Just make a debug
 918 build of lufs, try to replicate the problem and send me a bug report
 919 along with some log files. I will (try to) take care of the rest. </FONT></FONT>
 920 </P>
 921 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 922 <BR>
 923 </P>
 924 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 925 <FONT FACE="Courier, monospace"><FONT SIZE=3>[root@localhost]#
 926 ./configure -–enable-debug -–enable-kdebug</FONT></FONT></P>
 927 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 928 <FONT FACE="Courier, monospace"><FONT SIZE=3>[root@localhost]# make
 929 clean</FONT></FONT></P>
 930 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 931 <FONT FACE="Courier, monospace"><FONT SIZE=3>[root@localhost]# make </FONT></FONT>
 932 </P>
 933 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 934 <FONT FACE="Courier, monospace"><FONT SIZE=3>[root@localhost]# make
 935 install</FONT></FONT></P>
 936 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 937 <BR>
 938 </P>
 939 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 940 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>When mounting, redirect
 941 stdout and stderr to some files :</FONT></FONT></P>
 942 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 943 <BR>
 944 </P>
 945 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 946 <FONT FACE="Courier, monospace"><FONT SIZE=3>[root@localhost]#
 947 lufsmount ftpfs://mali@ftp.sourceforge.net ~/mnt &gt;lufsd.log
 948 2&gt;lufsd.err</FONT></FONT></P>
 949 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 950 <BR>
 951 </P>
 952 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><SPAN LANG="en-US"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">Now
 953 try to replicate the problem and send me a bug report along with
 954 </SPAN><B>lufsd.err</B><SPAN STYLE="font-weight: medium"> and
 955 </SPAN><B>lufsd.log</B><SPAN STYLE="font-weight: medium"> plus a tail
 956 of your </SPAN><B>/var/log/messages</B><SPAN STYLE="font-weight: medium">
 957 (or whatever holds your kernel's logs). The bug report should contain
 958 information about you system (distro, kernel version, gcc version,
 959 etc.) and a description of what you did to bring up the bug.</SPAN></FONT></FONT></SPAN></SPAN></P>
 960 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 961 <BR>
 962 </P>
 963 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 964 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Your help will be
 965 appreciated!</FONT></FONT></P>
 966 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 967 <BR>
 968 </P>
 969 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 970 </P>
 971 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 972 </P>
 973 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; page-break-before: always">
 974 <FONT FACE="Arial, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><U><B>4.
 975 USAGE</B></U></FONT></FONT></P>
 976 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 977 <BR>
 978 </P>
 979 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 980 <FONT FACE="Arial, sans-serif"><FONT SIZE=4>4.1 MOUNTING:</FONT></FONT></P>
 981 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
 982 </P>
 983 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>NOTE:
 984 </B>R<SPAN STYLE="font-weight: medium">egular users can mount/unmount
 985 lufs file systems using </SPAN><B>lufsmount/lufsumount</B><SPAN STYLE="font-weight: medium">
 986 if suid is set on these mount wrappers (see </SPAN><B>INSTALLATION</B><SPAN STYLE="font-weight: medium">).</SPAN></FONT></FONT></P>
 987 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 988 <BR>
 989 </P>
 990 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">For
 991 your convenience, a mounting utility is provided (</SPAN><B>lufsmount)</B><SPAN STYLE="font-weight: medium">
 992 which allows a more natural interface. </SPAN></FONT></FONT></SPAN>
 993 </P>
 994 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 995 <BR>
 996 </P>
 997 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
 998 <FONT FACE="Courier, monospace"><FONT SIZE=3>Lufsmount
 999 &lt;file_system&gt;://[&lt;user&gt;[:&lt;pass&gt;]@][&lt;host&gt;][:&lt;port&gt;][/&lt;remote_root&gt;]
1000 &lt;mountpoint&gt; [OPTIONS]</FONT></FONT></P>
1001 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1002 <BR>
1003 </P>
1004 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1005 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The <B>-h</B> flag
1006 provides a complete description of the available options.</FONT></FONT></P>
1007 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
1008 </P>
1009 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Notes:</B><SPAN STYLE="font-weight: medium">
1010 </SPAN></FONT></FONT>
1011 </P>
1012 <UL>
1013         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none">
1014         <FONT FACE="Arial, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: medium">“/”,
1015         ”:”, “@” are treated as separators by lufsmount. If one of
1016         the parameters contains such characters, you shouldn't use
1017         lufsmount.</SPAN><B> </B></FONT></FONT>
1018         </P>
1019         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none">
1020         <FONT FACE="Arial, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: medium">lufsmount
1021         is just a parameter parser actually, which in turn calls </SPAN><B>lufsd</B><SPAN STYLE="font-weight: medium">
1022         with formated parameters, so you could use lufsd if you run into
1023         lufsmount's limitations.</SPAN></FONT></FONT></P>
1024 </UL>
1025 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1026 <BR>
1027 </P>
1028 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1029 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Another way to mount a
1030 LUFS is by calling <B>lufsd</B> directly:</FONT></FONT></P>
1031 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1032 <BR>
1033 </P>
1034 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Courier, monospace"><SPAN STYLE="font-weight: medium">lufsd
1035 none </SPAN><B>mountpoint</B><SPAN STYLE="font-weight: medium"> -o
1036 options[...]</SPAN></FONT></FONT></SPAN></P>
1037 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1038 <BR>
1039 </P>
1040 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1041 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>where the options have
1042 exactly the same syntax as when using mount (see below).</FONT></FONT></P>
1043 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1044 <BR>
1045 </P>
1046 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1047 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Besides lufsmount &amp;
1048 lufsd, you can always count on good ol' mount. You'll probably not be
1049 able to use mount as a regular user though... The general syntax for
1050 mounting a LUFS file system is</FONT></FONT></P>
1051 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1052 <BR>
1053 </P>
1054 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Courier, monospace"><SPAN STYLE="font-weight: medium">mount
1055 -t lufs none </SPAN><B>mountpoint </B><SPAN STYLE="font-weight: medium">-o
1056 nosuid,fs=</SPAN><B>file_system</B><SPAN STYLE="font-weight: medium">[,uid=</SPAN><B>id</B><SPAN STYLE="font-weight: medium">][,gid=</SPAN><B>id</B><SPAN STYLE="font-weight: medium">][,fmask=</SPAN><B>mode</B><SPAN STYLE="font-weight: medium">][,dmask=</SPAN><B>mode</B><SPAN STYLE="font-weight: medium">][,channels=</SPAN><B>nr_chan</B><SPAN STYLE="font-weight: medium">][,root=</SPAN><B>remote_root</B><SPAN STYLE="font-weight: medium">][,</SPAN><B>own_fs][,quiet][,...]</B></FONT></FONT></SPAN></P>
1057 <P ALIGN=JUSTIFY STYLE="margin-left: 0.48cm; margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1058 <BR>
1059 </P>
1060 <UL>
1061         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">fs=</SPAN><B>file_system      </B><SPAN STYLE="font-weight: medium">:
1062         the file system type to mount (localfs, sshfs, ftpfs)</SPAN></FONT></FONT></SPAN></P>
1063         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1064         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>uid=<B>id</B>               : the uid
1065         to own the mounted fs</FONT></FONT></P>
1066         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1067         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>gid=<B>id</B>               : the gid
1068         to own the mounted fs</FONT></FONT></P>
1069         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1070         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>fmask=<B>mode</B>   : the
1071         minimal permissions to be set on each file</FONT></FONT></P>
1072         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1073         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>dmask=<B>mode</B>   : the
1074         minimal permissions to be set on each directory</FONT></FONT></P>
1075         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">channels=</SPAN><B>nr_chan</B><SPAN STYLE="font-weight: medium">      :
1076         the number of communication channels to open for a mounted fs</SPAN></FONT></FONT></SPAN></P>
1077         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif">root=<B>remote_root</B><SPAN STYLE="font-weight: medium">        :
1078         the remote directory to be mapped on the file system's root</SPAN></FONT></P>
1079         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>own_fs</B><SPAN STYLE="font-weight: medium">          :
1080         the whole file system will be owned by the mounting user</SPAN></FONT></P>
1081         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif"><B>quiet</B><SPAN STYLE="font-weight: medium">           :
1082         disable all logging (close all file descriptors)</SPAN></FONT></P>
1083         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium">
1084         <FONT FACE="Arial, sans-serif">dir_cache_ttl=<B>secs</B>        : number of
1085         seconds a directory cache entry is valid</FONT></P>
1086 </UL>
1087 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
1088 </P>
1089 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1090 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The <B>nosuid</B> option
1091 is automatically appended, so that all the remote file systems are
1092 treated as untrusted.</FONT></FONT></P>
1093 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1094 <BR>
1095 </P>
1096 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1097 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Sensitive information
1098 (passwords) will not be written in /etc/mtab.</FONT></FONT></P>
1099 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1100 <BR>
1101 </P>
1102 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1103 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>The number of
1104 communication channels represents the number of independent channels
1105 that will be used for a mounted file system. More of these insure
1106 better performance when multiple processes access the file system.
1107 Ideally, one channel per accessing process would allow optimum
1108 performance. There is a channel setup and resource overhead though,
1109 so a number of ~7 channels should not be exceeded. In some cases,
1110 multiple channels may cause problems (ftp servers only allowing a
1111 limited number of logins from a certain IP), so the <FONT FACE="Courier, monospace">channels</FONT>
1112 option allows you to specify a reduced number (possibly 1).</FONT></FONT></P>
1113 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1114 <BR>
1115 </P>
1116 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1117 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>For file system specific
1118 options and examples check out the <B>FILE SYSTEMS</B> section.</FONT></FONT></P>
1119 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1120 <BR>
1121 </P>
1122 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1123 <BR>
1124 </P>
1125 <P STYLE="margin-bottom: 0cm; font-weight: medium"><BR>
1126 </P>
1127 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1128 <FONT FACE="Arial, sans-serif"><FONT SIZE=4>4.2 UNMOUNTING:</FONT></FONT></P>
1129 <P STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
1130 </P>
1131 <P STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">As
1132 root, you can simply use </SPAN><B>umount</B><SPAN STYLE="font-weight: medium">
1133 in order to unmount a lufs file system. That is:</SPAN></FONT></FONT></SPAN></P>
1134 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1135 <BR>
1136 </P>
1137 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1138 <FONT FACE="Courier, monospace"><FONT SIZE=3>#umount /mnt/lufs</FONT></FONT></P>
1139 <P STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
1140 </P>
1141 <P STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><SPAN STYLE="font-weight: medium">A
1142 regular user will have to use the suid-ed </SPAN><B>lufsumount</B></FONT></FONT></SPAN>:</P>
1143 <P STYLE="margin-bottom: 0cm"><BR>
1144 </P>
1145 <P STYLE="margin-bottom: 0cm"><FONT FACE="Courier, monospace">$lufsumount
1146 ~/mnt/lufs</FONT></P>
1147 <P STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
1148 </P>
1149 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1150 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Of course, a regular user
1151 will only be able to unmount file systems mounted by himself.</FONT></FONT></P>
1152 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1153 <BR>
1154 </P>
1155 <P STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
1156 </P>
1157 <P STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1158 <FONT FACE="Arial, sans-serif"><FONT SIZE=4>4.3 AUTOFS SUPPORT:</FONT></FONT></P>
1159 <P STYLE="margin-bottom: 0cm; text-decoration: none"><BR>
1160 </P>
1161 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1162 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>LUFS provides autofs
1163 executable maps for ftpfs and sshfs (auto.ftpfs and auto.sshfs).
1164 These can be used in <B>/etc/auto.master</B> as follows:</FONT></FONT></P>
1165 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1166 <BR>
1167 </P>
1168 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1169 <FONT FACE="Courier, monospace"><FONT SIZE=2># Sample auto.master
1170 file</FONT></FONT></P>
1171 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1172 <FONT FACE="Courier, monospace"><FONT SIZE=2># Format of this file:</FONT></FONT></P>
1173 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1174 <FONT FACE="Courier, monospace"><FONT SIZE=2># mountpoint map options</FONT></FONT></P>
1175 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1176 <FONT FACE="Courier, monospace"><FONT SIZE=2># For details of the
1177 format look at autofs(8).</FONT></FONT></P>
1178 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1179 <FONT FACE="Courier, monospace"><FONT SIZE=2>/mnt/net/ssh
1180 /etc/auto.sshfs --timeout=60</FONT></FONT></P>
1181 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1182 <FONT FACE="Courier, monospace"><FONT SIZE=2>/mnt/net/ftp
1183 /etc/auto.ftpfs --timeout=60</FONT></FONT></P>
1184 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1185 <BR>
1186 </P>
1187 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1188 <BR>
1189 </P>
1190 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1191 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Then, after restarting
1192 automount (/etc/init.d/autofs restart), you can access ssh and ftp
1193 servers more easily:</FONT></FONT></P>
1194 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1195 <BR>
1196 </P>
1197 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1198 <FONT FACE="Courier, monospace"><FONT SIZE=2>$ cd
1199 /mnt/net/ftp/ftp.kernel.org/pub</FONT></FONT></P>
1200 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1201 <FONT FACE="Courier, monospace"><FONT SIZE=2>$ ls -al
1202 /mnt/net/ssh/mali@lufs.sourceforge.net</FONT></FONT></P>
1203 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1204 <BR>
1205 </P>
1206 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1207 <BR>
1208 </P>
1209 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1210 <FONT FACE="Arial, sans-serif"><FONT SIZE=3>Mounting and unmounting
1211 is taken care of by autofs.</FONT></FONT></P>
1212 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1213 <BR>
1214 </P>
1215 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=3><B>Notes:</B></FONT></FONT></P>
1216 <UL>
1217         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; text-decoration: none">
1218         <FONT FACE="Arial, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: medium">the
1219         --</SPAN><B>enable-autofs-install</B><SPAN STYLE="font-weight: medium">
1220         configure parameter will configure autofs for </SPAN><B>/mnt/net/ssh</B><SPAN STYLE="font-weight: medium">
1221         and </SPAN><B>/mnt/net/ftp </B><SPAN STYLE="font-weight: medium">automatically.</SPAN></FONT></FONT></P>
1222         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1223         <FONT FACE="Arial, sans-serif"><FONT SIZE=3>for sshfs to function
1224         properly under autofs, public key authentication must be configured
1225         for root (or whoever is running automount - see the SSHFS section).</FONT></FONT></P>
1226 </UL>
1227 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1228 <BR>
1229 </P>
1230 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1231 <BR>
1232 </P>
1233 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1234 <FONT FACE="Arial, sans-serif"><FONT SIZE=4>4.4 PERMISSIONS MAPPING</FONT></FONT></P>
1235 <OL START=4>
1236         <OL START=4>
1237                 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1238                 </P>
1239         </OL>
1240 </OL>
1241 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif">Two
1242 methods are available for mapping remote permissions locally:</FONT></FONT></SPAN></SPAN></P>
1243 <P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm; font-weight: medium; text-decoration: none">
1244 <BR>
1245 </P>
1246 <UL>
1247         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><B><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif">normal
1248         mapping:</FONT></FONT></SPAN></B><SPAN STYLE="font-weight: medium"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif">     the
1249         file/dir permissions are preserved and the owner changed accordingly
1250         (either the mounting user, or some neutral – uid=gid=2 – if the
1251         file is not owned remotely). This mode is active by default.</FONT></FONT></SPAN></SPAN></P>
1252         <LI><P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><SPAN STYLE="text-decoration: none"><FONT SIZE=3><FONT FACE="Arial, sans-serif"><B>forced
1253         ownership:</B><SPAN STYLE="font-weight: medium">        all the files/dirs
1254         are owned by the mounting user and the permissions are changed to
1255         reflect real access rights (if the file is not owned remotely, then
1256         the local “user” and “group” permissions will be the same as
1257         remote “other”). This mode is activate</SPAN><SPAN STYLE="font-weight: medium">d
1258         by the </SPAN><B>own_fs</B><SPAN STYLE="font-weight: medium">
1259         option.</SPAN></FONT></FONT></SPAN></P>
1260 </UL>
1261 </BODY>
1262 </HTML>