summaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/interface.md
blob: 539e39272b0368419eaba0e41014037529a26bd2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
---
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: interface
Arg: <name>
Help: Use network interface
Category: connection
Added: 7.3
Multi: single
See-also:
  - dns-interface
Example:
  - --interface eth0 $URL
  - --interface "host!10.0.0.1" $URL
  - --interface "if!enp3s0" $URL
---

# `--interface`

Perform the operation using a specified interface. You can enter interface
name, IP address or hostname. If you prefer to be specific, you can use the
following special syntax:

## if!<name>

Interface name. If the provided name does not match an existing interface,
curl returns with error 45.

## host!<name>

IP address or hostname.

## ifhost!<interface>!<host>

Interface name and IP address or hostname. This syntax requires libcurl 8.9.0
or later.

If the provided name does not match an existing interface, curl returns with
error 45.

##

curl does not support using network interface names for this option on
Windows.

That name resolve operation if a hostname is provided does **not** use
DNS-over-HTTPS even if --doh-url is set.

On Linux this option can be used to specify a **VRF** (Virtual Routing and
Forwarding) device, but the binary then needs to either have the
**CAP_NET_RAW** capability set or to be run as root.