diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2020-12-12 22:23:19 +0100 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2020-12-13 12:24:57 +0100 |
| commit | 7ba257798854a3bc2c77a6762ac43d64dbefe4e7 (patch) | |
| tree | 9436c4b16a3f8022554d0811d4a4da50ee627d42 | |
| parent | b90c23d5807f9d4f5236d54dd2df0a1a1dcf248c (diff) | |
| download | curl-7ba257798854a3bc2c77a6762ac43d64dbefe4e7.tar.gz | |
URL-SYNTAX: mention how FILE:// access can access network on windows
Closes #6314
| -rw-r--r-- | docs/URL-SYNTAX.md | 13 |
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 |