xref: /aosp_15_r20/external/curl/docs/cmdline-opts/data-binary.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: data-binary
5*6236dae4SAndroid Build Coastguard WorkerArg: <data>
6*6236dae4SAndroid Build Coastguard WorkerHelp: HTTP POST binary data
7*6236dae4SAndroid Build Coastguard WorkerProtocols: HTTP
8*6236dae4SAndroid Build Coastguard WorkerCategory: http post upload
9*6236dae4SAndroid Build Coastguard WorkerAdded: 7.2
10*6236dae4SAndroid Build Coastguard WorkerMulti: append
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - data-ascii
13*6236dae4SAndroid Build Coastguard WorkerExample:
14*6236dae4SAndroid Build Coastguard Worker  - --data-binary @filename $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--data-binary`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerPost data exactly as specified with no extra processing whatsoever.
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard WorkerIf you start the data with the letter @, the rest should be a filename.
22*6236dae4SAndroid Build Coastguard Worker`@-` makes curl read the data from stdin. Data is posted in a similar
23*6236dae4SAndroid Build Coastguard Workermanner as --data does, except that newlines and carriage returns are
24*6236dae4SAndroid Build Coastguard Workerpreserved and conversions are never done.
25*6236dae4SAndroid Build Coastguard Worker
26*6236dae4SAndroid Build Coastguard WorkerLike --data the default content-type sent to the server is
27*6236dae4SAndroid Build Coastguard Workerapplication/x-www-form-urlencoded. If you want the data to be treated as
28*6236dae4SAndroid Build Coastguard Workerarbitrary binary data by the server then set the content-type to octet-stream:
29*6236dae4SAndroid Build Coastguard Worker-H "Content-Type: application/octet-stream".
30*6236dae4SAndroid Build Coastguard Worker
31*6236dae4SAndroid Build Coastguard WorkerIf this option is used several times, the ones following the first append
32*6236dae4SAndroid Build Coastguard Workerdata as described in --data.
33