<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry id="smbmount">

<refmeta>
	<refentrytitle>smbmount</refentrytitle>
	<manvolnum>8</manvolnum>
</refmeta>


<refnamediv>
	<refname>smbmount</refname>
	<refpurpose>mount and smbfs filesystem</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
		<command>smbumount</command>
		<arg choice="req">service</arg>
		<arg choice="req">mount-point</arg>
		<arg choice="opt">-o options</arg>
	</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>

	<para><command>smbmount</command> mounts a SMB filesystem. It 
	is usually invoked as <command>mount.smb</command> from 
	the <command>mount(8)</command> command when using the 
	"-t smb" option. The kernel must support the smbfs filesystem. </para>

	<para>Options to smbmount are specified as a comma separated list 
	of key=value pairs.</para>

	<para><emphasis>NOTE:</emphasis> <command>smbmount</command> 
	calls <command>smbmnt(8)</command> to do the actual mount. You 
	must make sure that <command>smbmnt</command> is in the path so 
	that it can be found. </para>
	
</refsect1>

<refsect1>
	<title>OPTIONS</title>

	<variablelist>
		<varlistentry>
		<term>username=&lt;arg&gt;</term>
		<listitem><para>specifies the username to connect as. If
		this is not given then the environment variable <parameter>
		$USER</parameter> is used. This option can also take the 
		form "user%password" or "user/workgroup" or 
		"user/workgroup%password" to allow the password and workgroup 
		to be specified as part of the username.</para></listitem>
		</varlistentry>


		<varlistentry>
		<term>password=&lt;arg&gt;</term>
		<listitem><para>specifies the SMB password. If not given then 
		<command>smbmount</command> will prompt for a passeword, unless 
		the guest option is given. </para></listitem>
		</varlistentry>



		<varlistentry>
		<term>netbiosname=&lt;arg&gt;</term>
		<listitem><para>sets the source NetBIOS name. It defaults 
		to the local hostname. </para></listitem>
		</varlistentry>



		<varlistentry>
		<term>uid=&lt;arg&gt;</term>
		<listitem><para>sets the uid that files will be mounted as. 
		It may be specified as either a username or a numeric uid.
		</para></listitem>
		</varlistentry>
		
		
		<varlistentry>
		<term>gid=&lt;arg&gt;</term>
		<listitem><para>sets the gid that files will be mounted as. 
		It may be specified as either a groupname or a numeric 
		gid. </para></listitem>		
		</varlistentry>
		
		
		<varlistentry>
		<term>port=&lt;arg&gt;</term>
		<listitem><para>sets the remote SMB port number. The default 
		is 139. </para></listitem>
		</varlistentry>
		
		
		<varlistentry>
		<term>fmask=&lt;arg&gt;</term>
		<listitem><para>sets the file mask. This determines the 
		permissions that remote files have in the local filesystem. 
		The default is based on the current umask. </para></listitem>
		</varlistentry>
		

		<varlistentry>
		<term>dmask=&lt;arg&gt;</term>
		<listitem><para>sets the directory mask. This deterines the 
		permissions that remote directories have in the local filesystem. 
		The default is based on the current umask. </para></listitem>
		</varlistentry>
		
		
		<varlistentry>
		<term>debug=&lt;arg&gt;</term>
		<listitem><para>sets the debug level. This is useful for 
		tracking down SMB connection problems. </para></listitem>
		</varlistentry>
		
		
		<varlistentry>
		<term>ip=&lt;arg&gt;</term>
		<listitem><para>sets the destination host or IP address.
		</para></listitem>
		</varlistentry>



		<varlistentry>
		<term>workgroup=&lt;arg&gt;</term>
		<listitem><para>sets the workgroup on the destination </para>
		</listitem>
		</varlistentry>


		<varlistentry>
		<term>sockopt=&lt;arg&gt;</term>
		<listitem><para>sets the TCP socket options. See the <ulink
		url="smb.conf.5.html#SOCKETOPTIONS"><filename>smb.conf
		</filename></ulink> <parameter>socket options</parameter> option.
		</para></listitem>
		</varlistentry>


		<varlistentry>
		<term>scope=&lt;arg&gt;</term>
		<listitem><para>sets the NetBIOS scope </para></listitem>
		</varlistentry>

		<varlistentry>
		<term>guest</term>
		<listitem><para>don't prompt for a password </para></listitem>
		</varlistentry>


		<varlistentry>
		<term>ro</term>
		<listitem><para>mount read-only </para></listitem>
		</varlistentry>

		<varlistentry>
		<term>rw</term><listitem><para>mount read-write </para></listitem>
		</varlistentry>
	</variablelist>


</refsect1>


<refsect1>
	<title>AUTHOR</title>
	
	<para>The current maintainer of smbfs and the userspace
	tools <command>smbmount</command>, <command>smbumount</command>,
	and <command>smbmnt</command> is <ulink 
	url="mailto:urban@teststation.com">Urban Widmark</ulink></para>
	
	<para>The conversion of this manpage for Samba 2.2 was performed 
	by Gerald Carter</para>
</refsect1>

</refentry>