interface.md (1285B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Long: interface 5 Arg: <name> 6 Help: Use network interface 7 Category: connection 8 Added: 7.3 9 Multi: single 10 See-also: 11 - dns-interface 12 Example: 13 - --interface eth0 $URL 14 - --interface "host!10.0.0.1" $URL 15 - --interface "if!enp3s0" $URL 16 --- 17 18 # `--interface` 19 20 Perform the operation using a specified interface. You can enter interface 21 name, IP address or hostname. If you prefer to be specific, you can use the 22 following special syntax: 23 24 ## if!<name> 25 26 Interface name. If the provided name does not match an existing interface, 27 curl returns with error 45. 28 29 ## host!<name> 30 31 IP address or hostname. 32 33 ## ifhost!<interface>!<host> 34 35 Interface name and IP address or hostname. This syntax requires libcurl 8.9.0 36 or later. 37 38 If the provided name does not match an existing interface, curl returns with 39 error 45. 40 41 ## 42 43 curl does not support using network interface names for this option on 44 Windows. 45 46 That name resolve operation if a hostname is provided does **not** use 47 DNS-over-HTTPS even if --doh-url is set. 48 49 On Linux this option can be used to specify a **VRF** (Virtual Routing and 50 Forwarding) device, but the binary then needs to either have the 51 **CAP_NET_RAW** capability set or to be run as root.