summaryrefslogtreecommitdiff
path: root/docs/manpages/smbmnt.8
blob: c9d7b61c35f37eeffd0d57e245172723459b6a6f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
.TH SMBMNT 8 "19 Sep 1998" "smbmnt 2.0.0-alpha6"
.SH NAME
smbmnt \- mount smb file system
.SH SYNOPSIS
.B smbmnt
.B mount-point
[
.B -u
.I uid
] [
.B -g
.I gid
] [
.B -f
.I file mode
] [
.B -d
.I dir mode
]

.SH DESCRIPTION
.B smbmnt 
is a helper application used by the 
.BI smbmount (8)
program to do the actual mounting.
.B smbmnt
is meant to be installed setuid root so that normal users can mount
their smb shares. It checks whether the user has write permissions
on the mount point and then mounts the directory.

The
.B smbmnt
program is normally invoked by a mount command to
.BI smbmount ,
and the command line arguments are passed directly to
.B smbmnt.

.SH OPTIONS
.B -u
.I uid,
.B -g
.I gid
.RS 3
A Lan Manager server does not tell us anything about the owner of a
file, but Unix requires that each file have an owner and a group it belongs
to. With 
.B -u
and
.B -g
you can tell smbmount which id's it should assign to the files in the
mounted directory.

The defaults for these values are the current uid and gid.
.RE

.B -f
.I file mode,
.B -d
.I dir mode
.RS 3
Like 
.B -u
and
.B -g,
these options are also used to bridge differences in concepts between
Lan Manager and Unix. Lan Manager does not know anything about file
permissions, so
.B smbmnt
must be told which permissions it should assign to the mounted files
and directories.

The values must be given as octal numbers. The default values are taken
from the current umask, where the file mode is the current umask,
and the dir mode adds execute permissions where the file mode gives
read permissions.

Note that these permissions can differ from the rights the server
gives to us. If you do not have write permissions on the server,
you should choose a file mode that matches your actual permissions.
This certainly cannot override the restrictions imposed by the server.

In addition to specifying the file mode, the
.B -f
argument can be used to specify certain bug-fix workarounds.
This allows bug fixes to be enabled on a per mount-point basis,
rather than being compiled into the kernel.
The required bug fixes are specified by prepending an (octal) value
to the file mode.
For information on the available bug workarounds, refer to the
.B smbfs.txt
file in the Linux kernel Documentation directory. 
.RE

.SH SEE ALSO
.B smbmount(8)