aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/etag-save.d
diff options
context:
space:
mode:
authorMaros Priputen <maros.priputen@student.tuke.sk>2019-10-30 09:43:14 +0100
committerDaniel Stenberg <daniel@haxx.se>2019-11-28 13:05:20 +0100
commit18e5cb77e986911063da8ab6bf254d632b2de6ea (patch)
treee86358f792c99440d2cb2eebe3a8518514816cc1 /docs/cmdline-opts/etag-save.d
parent1ff63fa69baf617eee856ea30db7ae23134e46fd (diff)
curl: two new command line options for etags
--etag-compare and --etag-save Suggested-by: Paul Hoffman Fixes #4277 Closes #4543
Diffstat (limited to 'docs/cmdline-opts/etag-save.d')
-rw-r--r--docs/cmdline-opts/etag-save.d15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/cmdline-opts/etag-save.d b/docs/cmdline-opts/etag-save.d
new file mode 100644
index 000000000..fa0694d14
--- /dev/null
+++ b/docs/cmdline-opts/etag-save.d
@@ -0,0 +1,15 @@
+Long: etag-save
+Arg: <file>
+Help: Parse ETag from a request and save it to a file
+Protocols: HTTP
+---
+This option saves an HTTP ETag to the specified file. Etag is
+usually part of headers returned by a request. When server sends an
+ETag, it must be enveloped by a double quote. This option extracts the
+ETag without the double quotes and saves it into the <file>.
+
+A server can send a week ETag which is prefixed by "W/". This identifier
+is not considered, and only relevant ETag between quotation marks is parsed.
+
+It an ETag wasn't send by the server or it cannot be parsed, and empty
+file is created.