Add more content to the description of "registry shares".
[Samba/bjacke.git] / docs / manpages-3 / smbmnt.8.xml
blob9425ce7c316732f883c7915d108d4a45c6a7a899
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
3 <refentry id="smbmnt.8">
5 <refmeta>
6         <refentrytitle>smbmnt</refentrytitle>
7         <manvolnum>8</manvolnum>
8 </refmeta>
11 <refnamediv>
12         <refname>smbmnt</refname>
13         <refpurpose>helper utility for mounting SMB filesystems</refpurpose>
14 </refnamediv>
16 <refsynopsisdiv>
17         <cmdsynopsis>
18                 <command>smbmnt</command>
19                 <arg choice="req">mount-point</arg>
20                 <arg choice="opt">-s &lt;share&gt;</arg>
21                 <arg choice="opt">-r</arg>
22                 <arg choice="opt">-u &lt;uid&gt;</arg>
23                 <arg choice="opt">-g &lt;gid&gt;</arg>
24                 <arg choice="opt">-f &lt;mask&gt;</arg>
25                 <arg choice="opt">-d &lt;mask&gt;</arg>
26                 <arg choice="opt">-o &lt;options&gt;</arg>
27                 <arg choice="opt">-h</arg>
28         </cmdsynopsis>
29 </refsynopsisdiv>
31 <refsect1>
32         <title>DESCRIPTION</title>
34         <para><command>smbmnt</command> is a helper application used 
35         by the smbmount program to do the actual mounting of SMB shares. 
36         <command>smbmnt</command> can be installed setuid root if you want
37         normal users to be able to mount their SMB shares.</para>
39         <para>A setuid smbmnt will only allow mounts on directories owned
40         by the user, and that the user has write permission on.</para>
42         <para>The <command>smbmnt</command> program is normally invoked 
43         by <citerefentry><refentrytitle>smbmount</refentrytitle>
44         <manvolnum>8</manvolnum></citerefentry>. It should not be invoked directly by users. </para>
46         <para>smbmount searches the normal PATH for smbmnt. You must ensure
47         that the smbmnt version in your path matches the smbmount used.</para>
49 </refsect1>
51 <refsect1>
52         <title>OPTIONS</title>
54         <variablelist>
55                 <varlistentry>
56                 <term>-r</term>
57                 <listitem><para>mount the filesystem read-only 
58                 </para></listitem>
59                 </varlistentry>
61                 <varlistentry>
62                 <term>-u uid</term>
63                 <listitem><para>specify the uid that the files will 
64                 be owned by </para></listitem>
65                 </varlistentry>
67                 <varlistentry>
68                 <term>-g gid</term>
69                 <listitem><para>specify the gid that the files will be 
70                 owned by </para></listitem>
71                 </varlistentry>
73                 <varlistentry>
74                 <term>-f mask</term>
75                 <listitem><para>specify the octal file mask applied
76                 </para></listitem>
77                 </varlistentry>
79                 <varlistentry>
80                 <term>-d mask</term>
81                 <listitem><para>specify the octal directory mask 
82                 applied  </para></listitem>
83                 </varlistentry>
85                 <varlistentry>
86                 <term>-o options</term>
87                 <listitem><para>
88                 list of options that are passed as-is to smbfs, if this
89                 command is run on a 2.4 or higher Linux kernel.
90                 </para></listitem>
91                 </varlistentry>
93                 &stdarg.help;
95         </variablelist>
96 </refsect1>
99 <refsect1>
100         <title>AUTHOR</title>
101         
102         <para>Volker Lendecke, Andrew Tridgell, Michael H. Warfield 
103         and others.</para>
104         
105         <para>The current maintainer of smbfs and the userspace
106         tools <command>smbmount</command>, <command>smbumount</command>,
107         and <command>smbmnt</command> is <ulink 
108         url="mailto:urban@teststation.com">Urban Widmark</ulink>.
109         The <ulink url="mailto:samba@samba.org">SAMBA Mailing list</ulink>
110         is the preferred place to ask questions regarding these programs.
111         </para>
112         
113         <para>The conversion of this manpage for Samba 2.2 was performed 
114         by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0
115         was done by Alexander Bokovoy.</para>
116 </refsect1>
118 </refentry>