docs/docbook/manpages/smbmnt.8.sgml

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