xref: /aosp_15_r20/external/curl/docs/cmdline-opts/next.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 WorkerShort: :
5*6236dae4SAndroid Build Coastguard WorkerLong: next
6*6236dae4SAndroid Build Coastguard WorkerTags:
7*6236dae4SAndroid Build Coastguard WorkerProtocols:
8*6236dae4SAndroid Build Coastguard WorkerAdded: 7.36.0
9*6236dae4SAndroid Build Coastguard WorkerMagic: divider
10*6236dae4SAndroid Build Coastguard WorkerHelp: Make next URL use separate options
11*6236dae4SAndroid Build Coastguard WorkerCategory: curl
12*6236dae4SAndroid Build Coastguard WorkerMulti: append
13*6236dae4SAndroid Build Coastguard WorkerSee-also:
14*6236dae4SAndroid Build Coastguard Worker  - parallel
15*6236dae4SAndroid Build Coastguard Worker  - config
16*6236dae4SAndroid Build Coastguard WorkerExample:
17*6236dae4SAndroid Build Coastguard Worker  - $URL --next -d postthis www2.example.com
18*6236dae4SAndroid Build Coastguard Worker  - -I $URL --next https://example.net/
19*6236dae4SAndroid Build Coastguard Worker---
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard Worker# `--next`
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerUse a separate operation for the following URL and associated options. This
24*6236dae4SAndroid Build Coastguard Workerallows you to send several URL requests, each with their own specific options,
25*6236dae4SAndroid Build Coastguard Workerfor example, such as different usernames or custom requests for each.
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard Worker--next resets all local options and only global ones have their values survive
28*6236dae4SAndroid Build Coastguard Workerover to the operation following the --next instruction. Global options include
29*6236dae4SAndroid Build Coastguard Worker--verbose, --trace, --trace-ascii and --fail-early.
30*6236dae4SAndroid Build Coastguard Worker
31*6236dae4SAndroid Build Coastguard WorkerFor example, you can do both a GET and a POST in a single command line:
32*6236dae4SAndroid Build Coastguard Worker
33*6236dae4SAndroid Build Coastguard Worker    curl www1.example.com --next -d postthis www2.example.com
34