mirror of
https://github.com/chromium/crashpad.git
synced 2024-12-27 15:32:10 +08:00
6a5695967f
crashpad_http_upload sends HTTP POST multipart/form-data requests and receives responses in exactly the same manner that crashpad_handler does for crash report uploads, but separates it out for more general testing and debugging. Change-Id: I5c5919f9b1dc1e6be1e43b15a35b31f51add8a46
133 lines
3.7 KiB
Markdown
133 lines
3.7 KiB
Markdown
<!--
|
||
Copyright 2017 The Crashpad Authors. All rights reserved.
|
||
|
||
Licensed under the Apache License, Version 2.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software
|
||
distributed under the License is distributed on an "AS IS" BASIS,
|
||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
-->
|
||
|
||
# crashpad_http_upload(1)
|
||
|
||
## Name
|
||
|
||
crashpad_http_upload—Send an HTTP POST request
|
||
|
||
## Synopsis
|
||
|
||
**crashpad_http_uplaod** [_OPTION…_]
|
||
|
||
## Description
|
||
|
||
Performs an HTTP or HTTPS POST, building a `multipart/form-data` request from
|
||
key-value pairs and files in the manner of an HTML `<form>` with a POST action.
|
||
Provides the response.
|
||
|
||
Programs that use the Crashpad client library directly will not normally use
|
||
this tool. This tool is provided for debugging and testing as it isolates
|
||
Crashpad’s networking implementation normally used to upload crash reports to
|
||
a crash report collection server, making it available for more general use.
|
||
|
||
## Options
|
||
|
||
* **-f**, **--file**=_KEY_=_PATH_
|
||
|
||
Include _PATH_ in the request as a file upload, in the manner of an HTML
|
||
`<input type="file">` element. _KEY_ is used as the field name.
|
||
|
||
* **--no-upload-gzip**
|
||
|
||
Do not use `gzip` compression. Normally, the entire request body is
|
||
compressed into a `gzip` stream and transmitted with `Content-Encoding:
|
||
gzip`. This option disables compression, and is intended for use with servers
|
||
that don’t accept uploads compressed in this way.
|
||
|
||
* **-o**, **--output**=_FILE_
|
||
|
||
The response body will be written to _FILE_ instead of standard output.
|
||
|
||
* **-s**, **--string**=_KEY_=_VALUE_
|
||
|
||
Include _KEY_ and _VALUE_ in the request as an ordinary form field, in the
|
||
manner of an HTML `<input type="text">` element. _KEY_ is used as the field
|
||
name, and _VALUE_ is used as its value.
|
||
|
||
* **-u**, **--url**=_URL_
|
||
|
||
Send the request to _URL_. This option is required.
|
||
|
||
* **--help**
|
||
|
||
Display help and exit.
|
||
|
||
* **--version**
|
||
|
||
Output version information and exit.
|
||
|
||
## Examples
|
||
|
||
Uploads a file to an HTTP server running on `localhost`.
|
||
|
||
```
|
||
$ crashpad_http-upload --url http://localhost/upload_test \
|
||
--string=when=now --file=what=1040.pdf
|
||
Thanks for the upload!
|
||
```
|
||
|
||
This example corresponds to the HTML form:
|
||
|
||
```
|
||
<form action="http://localhost/upload_test" method="post">
|
||
<input type="text" name="when" value="now" />
|
||
<input type="file" name="what" />
|
||
<input type="submit" />
|
||
</form>
|
||
```
|
||
|
||
## Exit Status
|
||
|
||
* **0**
|
||
|
||
Success.
|
||
|
||
* **1**
|
||
|
||
Failure, with a message printed to the standard error stream. HTTP error
|
||
statuses such as 404 (Not Found) are included in the definition of failure.
|
||
|
||
## See Also
|
||
|
||
[crashpad_handler(8)](../handler/crashpad_handler.md)
|
||
|
||
## Resources
|
||
|
||
Crashpad home page: https://crashpad.chromium.org/.
|
||
|
||
Report bugs at https://crashpad.chromium.org/bug/new.
|
||
|
||
## Copyright
|
||
|
||
Copyright 2017 [The Crashpad
|
||
Authors](https://chromium.googlesource.com/crashpad/crashpad/+/master/AUTHORS).
|
||
|
||
## License
|
||
|
||
Licensed under the Apache License, Version 2.0 (the “License”);
|
||
you may not use this file except in compliance with the License.
|
||
You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software
|
||
distributed under the License is distributed on an “AS IS” BASIS,
|
||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|