summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2020-12-12 22:23:19 +0100
committerDaniel Stenberg <daniel@haxx.se>2020-12-13 12:24:57 +0100
commit7ba257798854a3bc2c77a6762ac43d64dbefe4e7 (patch)
tree9436c4b16a3f8022554d0811d4a4da50ee627d42 /docs
parentb90c23d5807f9d4f5236d54dd2df0a1a1dcf248c (diff)
downloadcurl-7ba257798854a3bc2c77a6762ac43d64dbefe4e7.tar.gz
URL-SYNTAX: mention how FILE:// access can access network on windows
Closes #6314
Diffstat (limited to 'docs')
-rw-r--r--docs/URL-SYNTAX.md13
1 files changed, 10 insertions, 3 deletions
diff --git a/docs/URL-SYNTAX.md b/docs/URL-SYNTAX.md
index 7892aa611..f724f75f8 100644
--- a/docs/URL-SYNTAX.md
+++ b/docs/URL-SYNTAX.md
@@ -200,9 +200,16 @@ curl only allows the hostname part of a FILE URL to be one out of these three
alternatives: `localhost`, `127.0.0.1` or blank ("", zero characters).
Anything else will make curl fail to parse the URL.
-On Windows, curl accepts that the FILE URL's path starts with a "drive
-letter". That's a single letter `a` to `z` followed by a colon or a pipe
-character (`|`).
+### Windows-specific FILE details
+
+curl accepts that the FILE URL's path starts with a "drive letter". That's a
+single letter `a` to `z` followed by a colon or a pipe character (`|`).
+
+The Windows operating system itself will convert some file accesses to perform
+network accesses over SMB/CIFS, through several different file path patterns.
+This way, a `file://` URL passed to curl *might* be converted into a network
+access inadvertently and unknowingly to curl. This is a Windows feature curl
+cannot control or disable.
## IMAP