Added initial unfs3 sources for version 0.9.22+dfsg-1maemo2
[unfs3] / unfs3 / doc / passwords.txt
1
2 unfs3 mount-time password support
3 =================================
4
5 Example exports file:
6
7 /tmp (rw,password=gazonk)
8
9 Syntax note: The password may contain any character, except
10 whitespace, comma and right parenthesis.
11
12
13 Mounting with clear-text passwords
14 ----------------------------------
15
16 mount yourhost:@password:gazonk/tmp /mnt
17
18 Note: When using @password, the password cannot contain slashes. 
19
20
21 Mounting with one-time passwords
22 --------------------------------
23
24 1. Communicate with the mount server and issue a mount for
25    "@getnonce". The returned filehandle is your nonce. 
26
27 2. Concatenate the nonce with the password, and run it through
28    MD5. Convert the result to a hexascii representation. 
29
30 3. Example mount command:
31
32 mount yourhost:@otp:851d689b11ed4779dd5fbb084b136c52/tmp /mnt
33
34 Step 1 and 2 can be done by using the "nfsotpclient" found in the
35 contrib directory.
36
37 Note: With otp:s, a race condition exists. Consider the following:
38
39 1) client A requests nonce, gets NA
40 2) client B requests nonce, gets NB
41 3) client A sends otp mount using NA
42 4) client B sends otp mount using NB
43
44 Step 3 will not succeed because the server only stores the last
45 nonce. Step 4 will succeed, though. Client A needs to fetch a new
46 nonce and retry the mount.