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