]> git.lizzy.rs Git - plan9front.git/blob - sys/man/4/lnfs
nusb manpages
[plan9front.git] / sys / man / 4 / lnfs
1 .TH LNFS 4
2 .SH NAME
3 lnfs \- long name file system
4 .SH SYNOPSIS
5 .B lnfs
6 [
7 .B -r
8 ]
9 [
10 .B -s
11 .I srvname
12 ]
13 .I mountpoint
14 .br
15 .B unlnfs
16 .I mountpoint
17 .SH DESCRIPTION
18 .I Lnfs
19 starts a process that mounts itself (see
20 .IR bind (2))
21 on
22 .IR mountpoint .
23 It presents a filtered view of the files under the mount
24 point, allowing users to use long file names
25 on file servers that do not support file names
26 longer than 27 bytes.
27 .PP
28 The names used in the underlying file system are
29 the base32 encoding of the md5 hash of the longer
30 file name.  The user need not know the mapping
31 since
32 .I lnfs
33 does all the work.
34 .I Lnfs
35 maintains a file
36 .B .longnames
37 in the directory
38 .I mountpoint
39 to record the long file names.
40 .PP
41 The options are:
42 .TP
43 .B -r
44 allow only read access to the file system
45 .TP
46 .B -s
47 provide a service name,
48 .IR srvname ,
49 to post in
50 .BR /srv .
51 Without this option, no posting is performed.
52 .PP
53 .I Unlnfs
54 renames files with shortened names to their actual long names.
55 It is useful once you have moved to a file server with true long name support.
56 .SH FILES
57 .B .longnames
58 .SH SOURCE
59 .B /sys/src/cmd/lnfs.c
60 .PP
61 .B /sys/src/cmd/unlnfs.c
62 .SH BUGS
63 This exists only to shame us into getting a real long
64 name file server working.