[linux-cifs-client] doc: clarify that mount.cifs never uses smb.conf

Commit Message

Suresh Jayaraman April 21, 2009, 9:52 a.m. UTC

Jeff Layton wrote:
> On Mon, 20 Apr 2009 10:09:12 +0530
> Suresh Jayaraman <[e-mail]> wrote:
> 
>> Hi Steve, Jeff,
>>
>> If the following mount.cifs doc patch makes sense, can this be
>> considered for merging? I have seen atleast a couple of bug reports that
>> reports that cifs is not honoring configuration setting in smb.conf.
>>
>> Thanks,
>>
>> Suresh Jayaraman wrote:
>>> It seems that for some users that are used to smbclient, it is not clear
>>> that mount.cifs never uses smb.conf for configuring client specific
>>> parameters. So, let's add this information to mount.cifs man page.
>>>
>>> Signed-off-by: Suresh Jayaraman <[e-mail]>
>>> ---
>>>
>>>  docs-xml/manpages-3/mount.cifs.8.xml |    6 ++++++
>>>  1 files changed, 6 insertions(+), 0 deletions(-)
>>>
>>> diff --git a/docs-xml/manpages-3/mount.cifs.8.xml b/docs-xml/manpages-3/mount.cifs.8.xml
>>> index d0affea..32b2970 100644
>>> --- a/docs-xml/manpages-3/mount.cifs.8.xml
>>> +++ b/docs-xml/manpages-3/mount.cifs.8.xml
>>> @@ -65,6 +65,12 @@ kernel log.
>>>  		the mounted resource is unmounted (usually via the umount utility).
>>>  	</para>
>>>  
>>> +	<para>
>>> +	Some samba client tools like smbclient(8) honours client-side
> 						  ^^^^^^^
> 					Should be "honour"

Ok
>>> +	configuration parameters present in smb.conf. Unlike those client tools,
>>> +	<emphasis>mount.cifs</emphasis> ignores smb.conf completely.
>>> +	</para>
>>> +
>>>  </refsect1>
>>>  
>>>  <refsect1>
> 
> Maybe this should go in the NOTES section?

It seems more appropriate to add in the NOTES section.
Here's the updated patch.


 docs-xml/manpages-3/mount.cifs.8.xml |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)

Patch

diff --git a/docs-xml/manpages-3/mount.cifs.8.xml b/docs-xml/manpages-3/mount.cifs.8.xml
index d0affea..c5b516b 100644
--- a/docs-xml/manpages-3/mount.cifs.8.xml
+++ b/docs-xml/manpages-3/mount.cifs.8.xml
@@ -544,6 +544,13 @@  read and used as the password.
 	<title>NOTES</title>
 	
 	<para>This command may be used only by root, unless installed setuid, in which case the noeexec and nosuid mount flags are enabled.</para>
+
+	<para>
+	Some samba client tools like smbclient(8) honour client-side
+	configuration parameters present in smb.conf. Unlike those client tools,
+	<emphasis>mount.cifs</emphasis> ignores smb.conf completely.
+	</para>
+
 </refsect1>
 
 <refsect1>