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 08:47:44 -0500
commit1f2cfa5951b293599a9055f52ba9f5198f36a3d0 (patch)
treef712685d1af894dc6478c210c51c64b9dae792bf
parent0bcced17e0758401f411e2fafa7388298d95450d (diff)
downloadsamba-1f2cfa5951b293599a9055f52ba9f5198f36a3d0.tar.gz
samba-1f2cfa5951b293599a9055f52ba9f5198f36a3d0.tar.bz2
samba-1f2cfa5951b293599a9055f52ba9f5198f36a3d0.zip
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> (This used to be commit ec87ae251bea2a8b63febcf3ceab8754d564bdeb)
-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 4c86c45ffa..b62bd3c892 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>