xref: /curl/docs/cmdline-opts/etag-compare.md (revision fe9f68fa)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: etag-compare
5Arg: <file>
6Help: Load ETag from file
7Protocols: HTTP
8Added: 7.68.0
9Category: http
10Multi: single
11See-also:
12  - etag-save
13  - time-cond
14Example:
15  - --etag-compare etag.txt $URL
16---
17
18# `--etag-compare`
19
20Make a conditional HTTP request for the specific ETag read from the given file
21by sending a custom If-None-Match header using the stored ETag.
22
23For correct results, make sure that the specified file contains only a single
24line with the desired ETag. An empty file is parsed as an empty ETag.
25
26Use the option --etag-save to first save the ETag from a response, and then
27use this option to compare against the saved ETag in a subsequent request.
28