diff options
Diffstat (limited to 'docs/cmdline-opts/etag-compare.d')
-rw-r--r-- | docs/cmdline-opts/etag-compare.d | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/cmdline-opts/etag-compare.d b/docs/cmdline-opts/etag-compare.d new file mode 100644 index 000000000..1c1364f43 --- /dev/null +++ b/docs/cmdline-opts/etag-compare.d @@ -0,0 +1,17 @@ +Long: etag-compare +Arg: <file> +Help: Pass an ETag from a file as a custom header +Protocols: HTTP +--- +This option makes a conditional HTTP request for the specific +ETag read from the given file by sending a custom If-None-Match +header using the extracted ETag. + +For correct results, make sure that specified file contains only a single +line with a desired ETag. An empty file is parsed as an empty ETag. + +Use the option --etag-save to first save the ETag from a response, and +then use this option to compare using the saved ETag in a subsequent request. + +\fCOMPARISON\fP: There are 2 types of comparison or ETags, Weak and Strong. +This option expects, and uses a strong comparison. |