docs/cmdline-opts/form.d

   1 Long: form
   2 Short: F
   3 Arg: <name=content>
   4 Help: Specify HTTP multipart POST data
   5 Protocols: HTTP
   6 Mutexed: data head upload
   7 ---
   8 This lets curl emulate a filled-in form in which a user has pressed the submit
   9 button. This causes curl to POST data using the Content-Type
  10 multipart/form-data according to RFC 2388. This enables uploading of binary
  11 files etc. To force the 'content' part to be a file, prefix the file name with
  12 an @ sign. To just get the content part from a file, prefix the file name with
  13 the symbol <. The difference between @ and < is then that @ makes a file get
  14 attached in the post as a file upload, while the < makes a text field and just
  15 get the contents for that text field from a file.
  16
  17 Example: to send an image to a server, where \&'profile' is the name of the
  18 form-field to which portrait.jpg will be the input:
  19
  20  curl -F profile=@portrait.jpg https://example.com/upload.cgi
  21
  22 To read content from stdin instead of a file, use - as the filename. This goes
  23 for both @ and < constructs. Unfortunately it does not support reading the
  24 file from a named pipe or similar, as it needs the full size before the
  25 transfer starts.
  26
  27 You can also tell curl what Content-Type to use by using 'type=', in a manner
  28 similar to:
  29
  30  curl -F "web=@index.html;type=text/html" example.com
  31
  32 or
  33
  34  curl -F "name=daniel;type=text/foo" example.com
  35
  36 You can also explicitly change the name field of a file upload part by setting
  37 filename=, like this:
  38
  39  curl -F "file=@localfile;filename=nameinpost" example.com
  40
  41 If filename/path contains ',' or ';', it must be quoted by double-quotes like:
  42
  43  curl -F "file=@\\"localfile\\";filename=\\"nameinpost\\"" example.com
  44
  45 or
  46
  47  curl -F 'file=@"localfile";filename="nameinpost"' example.com
  48
  49 Note that if a filename/path is quoted by double-quotes, any double-quote
  50 or backslash within the filename must be escaped by backslash.
  51
  52 See further examples and details in the MANUAL.
  53
  54 This option can be used multiple times.