summaryrefslogtreecommitdiff
path: root/docs/htmldocs/smbmnt.8.html
blob: 1f5f83f751cc8015f3a56494b4546f2415e8b377 (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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<?xml version="1.0"?>

<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
	        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

	<!ENTITY % globalentities SYSTEM 'global.ent'> %globalentities;
 ]>
<refentry id="smbmnt.8">

<refmeta>
	<refentrytitle>smbmnt</refentrytitle>
	<manvolnum>8</manvolnum>
</refmeta>


<refnamediv>
	<refname>smbmnt</refname>
	<refpurpose>helper utility for mounting SMB filesystems</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis sepchar=" ">
		<command moreinfo="none">smbmnt</command>
		<arg rep="norepeat" choice="req">mount-point</arg>
		<arg rep="norepeat" choice="opt">-s &lt;share&gt;</arg>
		<arg rep="norepeat" choice="opt">-r</arg>
		<arg rep="norepeat" choice="opt">-u &lt;uid&gt;</arg>
		<arg rep="norepeat" choice="opt">-g &lt;gid&gt;</arg>
		<arg rep="norepeat" choice="opt">-f &lt;mask&gt;</arg>
		<arg rep="norepeat" choice="opt">-d &lt;mask&gt;</arg>
		<arg rep="norepeat" choice="opt">-o &lt;options&gt;</arg>
		<arg rep="norepeat" choice="opt">-h</arg>
	</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>

	<para><command moreinfo="none">smbmnt</command> is a helper application used 
	by the smbmount program to do the actual mounting of SMB shares. 
	<command moreinfo="none">smbmnt</command> can be installed setuid root if you want
	normal users to be able to mount their SMB shares.</para>

	<para>A setuid smbmnt will only allow mounts on directories owned
	by the user, and that the user has write permission on.</para>

	<para>The <command moreinfo="none">smbmnt</command> program is normally invoked 
	by <citerefentry><refentrytitle>smbmount</refentrytitle>
	<manvolnum>8</manvolnum></citerefentry>. It should not be invoked directly by users. </para>

	<para>smbmount searches the normal PATH for smbmnt. You must ensure
	that the smbmnt version in your path matches the smbmount used.</para>

</refsect1>

<refsect1>
	<title>OPTIONS</title>

	<variablelist>
		<varlistentry>
		<term>-r</term>
		<listitem><para>mount the filesystem read-only 
		</para></listitem>
		</varlistentry>

		<varlistentry>
		<term>-u uid</term>
		<listitem><para>specify the uid that the files will 
		be owned by </para></listitem>
		</varlistentry>

		<varlistentry>
		<term>-g gid</term>
		<listitem><para>specify the gid that the files will be 
		owned by </para></listitem>
		</varlistentry>

		<varlistentry>
		<term>-f mask</term>
		<listitem><para>specify the octal file mask applied
		</para></listitem>
		</varlistentry>

		<varlistentry>
		<term>-d mask</term>
		<listitem><para>specify the octal directory mask 
		applied  </para></listitem>
		</varlistentry>

		<varlistentry>
		<term>-o options</term>
		<listitem><para>
		list of options that are passed as-is to smbfs, if this
		command is run on a 2.4 or higher Linux kernel.
		</para></listitem>
		</varlistentry>

		
<varlistentry>
<term>-h|--help</term>
<listitem><para>Print a summary of command line options.
</para></listitem>
</varlistentry>

	</variablelist>
</refsect1>


<refsect1>
	<title>AUTHOR</title>
	
	<para>Volker Lendecke, Andrew Tridgell, Michael H. Warfield 
	and others.</para>
	
	<para>The current maintainer of smbfs and the userspace
	tools <command moreinfo="none">smbmount</command>, <command moreinfo="none">smbumount</command>,
	and <command moreinfo="none">smbmnt</command> is <ulink url="mailto:urban@teststation.com">Urban Widmark</ulink>.
	The <ulink url="mailto:samba@samba.org">SAMBA Mailing list</ulink>
	is the preferred place to ask questions regarding these programs.
	</para>
	
	<para>The conversion of this manpage for Samba 2.2 was performed 
	by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0
	was done by Alexander Bokovoy.</para>
</refsect1>

</refentry>