summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSimo Sorce <idra@samba.org>2008-03-31 20:13:01 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 09:02:11 -0500
commit06687e3ff184e8cc1a9c502150e9cb2985a0f388 (patch)
tree7f232b94423511ab8aa4f0b701bef0333a59194b
parentc478fc1bf7acaf263ed95e9a00ab7c35a5a4cdc4 (diff)
downloadsamba-06687e3ff184e8cc1a9c502150e9cb2985a0f388.tar.gz
Better doc mount.cifs.
Original commit msg from Jeff: This patch adds a section to the mount.cifs manpage to clarify how mount.cifs treats delimiters and when it autoconverts them from one type to another. It also has it state that the use of forward slash as a delimiter is preferred and why. Signed-off-by: Jeff Layton <jlayton@redhat.com>
-rw-r--r--docs/manpages-3/mount.cifs.8.xml11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/manpages-3/mount.cifs.8.xml b/docs/manpages-3/mount.cifs.8.xml
index 4c86c45ffac..b62bd3c8923 100644
--- a/docs/manpages-3/mount.cifs.8.xml
+++ b/docs/manpages-3/mount.cifs.8.xml
@@ -499,6 +499,17 @@ port 445 is tried and if no response then port 139 is tried.
</refsect1>
<refsect1>
+ <title>SERVICE FORMATTING AND DELIMITERS</title>
+
+ <para>
+ It's generally preferred to use forward slashes (/) as a delimiter in service names. They are considered to be the "universal delimiter" since they are generally not allowed to be embedded within path components on Windows machines and the client can convert them to blackslashes (\) unconditionally. Conversely, backslash characters are allowed by POSIX to be part of a path component, and can't be automatically converted in the same way.
+ </para>
+ <para>
+ mount.cifs will attempt to convert backslashes to forward slashes where it's able to do so, but it cannot do so in any path component following the sharename.
+ </para>
+</refsect1>
+
+<refsect1>
<title>ENVIRONMENT VARIABLES</title>
<para>