curl/docs/cmdline-opts/etag-compare.md
Daniel Stenberg 7347ddc9e2
tool_operate: make --etag-compare always accept a non-existing file
Consider it a blank etag. It allows for more use cases when the file
just might not have been created yet.

Closes #15737
2024-12-13 15:48:27 +01:00

815 B

c SPDX-License-Identifier Long Arg Help Protocols Added Category Multi See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl etag-compare <file> Load ETag from file HTTP 7.68.0 http single
etag-save
time-cond
--etag-compare etag.txt $URL

--etag-compare

Make a conditional HTTP request for the specific ETag read from the given file by sending a custom If-None-Match header using the stored ETag.

For correct results, make sure that the specified file contains only a single line with the desired ETag. A non-existing or empty file is treated as an empty ETag.

Use the option --etag-save to first save the ETag from a response, and then use this option to compare against the saved ETag in a subsequent request.

Use this option with a single URL only.