Added initial unfs3 sources for version 0.9.22+dfsg-1maemo2
[unfs3] / unfs3 / doc / README.win
1
2 Building unfs3 for Windows
3 ==========================
4
5 Building unfs3 using MinGW
6 --------------------------
7 1. Build and install the oncrpc-ms library (http://oncrpc-ms.sourceforge.net/)
8
9 2. Configure unfs3 with:
10
11 LIBS="/myprefix/oncrpc-ms/lib/liboncrpc.a -lwsock32" CFLAGS="-I/myprefix/oncrpc-ms/include -DONCRPCDLL" ./configure --host=`gcc -dumpmachine`
12
13
14 Using unfs3 on Windows
15 ======================
16
17 Limitations
18 -----------
19 * Single-user mode is required. Internally, unfs3 assumes that it is
20   running with uid 0. 
21
22 * Foreground mode is required. 
23
24 * Inode numbers are emulated by hashing file paths. This means that
25   there's a small risk that two files ends up with the same inode
26   number.
27
28
29 Path syntax
30 -----------
31 unfs3 implements a virtual file system. The root "/" directory
32 contains the drive letters of the drives present on the system. Below
33 each drive letter, the actual drive contents is found. unfs3 uses
34 forward slashes instead of backslashes. This applies both to mount
35 requests and the exports-file. 
36
37
38 Example exports file
39 --------------------
40 /a (ro)
41 /c/windows/temp (rw)
42
43
44 Example invocation
45 ------------------
46 unfsd.exe -s -d -p -n 4711 -m 4711 -e exports
47
48
49 Example mount command from a Linux host
50 ---------------------------------------
51 mount -o port=4711,mountport=4711,mountvers=3,nfsvers=3,nolock,tcp mywindowshost:/c/windows/temp /mnt