Added manpages.
[samba.git] / docs / manpages / smbmnt.8
1 .TH SMBMNT 8 01/05/1998 smbmnt smbmnt
2 .SH NAME
3 smbmnt \- mount smb file system
4 .SH SYNOPSIS
5 .B smbmnt
6 .B mount-point
7 [
8 .B -u
9 .I uid
10 ] [
11 .B -g
12 .I gid
13 ] [
14 .B -f
15 .I file mode
16 ] [
17 .B -d
18 .I dir mode
19 ]
20
21 .SH DESCRIPTION
22 .B smbmnt 
23 is a little helper application for the smbmount program. smbmnt is
24 meant to be installed setuid root to enable normal users to mount
25 their smb shares. Smbmnt checks whether the user calling it has write
26 permissions on the mount point and then mounts the directory.
27
28 .B -u
29 .I uid,
30 .B -g
31 .I gid
32 .RS 3
33 A Lan Manager server does not tell us anything about the owner of a
34 file. Unix requires that each file has an owner and a group it belongs
35 to. With 
36 .B -u
37 and
38 .B -g
39 you can tell smbmount which id's it should assign to the files in the
40 mounted direcory.
41
42 The defaults for these values are the current uid and gid.
43 .RE
44
45 .B -f
46 .I file mode,
47 .B -d
48 .I dir mode
49 .RS 3
50 Like 
51 .B -u
52 and
53 .B -g,
54 these options are also used to bridge differences in concepts between
55 Lan Manager and unix. Lan Manager does not know anything about file
56 permissions. So smbmount has to be told which permissions it should
57 assign to the mounted files and direcories. The values have to be
58 given as octal numbers. The default values are taken from the current
59 umask, where the file mode is the current umask, and the dir mode adds
60 execute permissions where the file mode gives read permissions.
61
62 Note that these permissions can differ from the rights the server
63 gives to us. If you do not have write permissions on the server, you
64 can very well choose a file mode that tells that you have. This
65 certainly cannot override the restrictions imposed by the server.
66 .RE
67
68
69 .SH SEE ALSO
70 .B smbmount(8)
71