docs/manpages/smbmnt.8.xml

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