dhcrelay8
Dynamic host configuration protocol (dhcp) relay agent
Usage
dhcrelay [-dor]
[-C
circuit-id]
[-R
remote-id]
-i
interface
destination ...
Overview
The dhcrelay utility provides a means for relaying DHCP and BOOTP requests from a subnet to which no DHCP server is directly connected to one or more DHCP servers on other subnets.
dhcrelay listens for DHCP requests on a given interface. When a query is received, dhcrelay forwards it to the list of DHCP destinations specified on the command line. When a reply is received, it is broadcast or unicast on the network from whence the original request came.
The server might be a name, address or interface. dhcrelay will operate in layer 2 mode when the specified servers are interfaces, otherwise it will operate in layer 3 mode.
The name of at least one DHCP server to which DHCP and BOOTP requests should be relayed, as well as the name of the network interface that dhcrelay should attempt to configure, must be specified on the command line.
dhcrelay supports relaying of DHCP traffic to configure IPsec tunnel mode clients when listening on the enc(4) interface using layer 3 mode only. The DHCP server has to support RFC 3046 to echo back the relay agent information to allow stateless DHCP reply to IPsec tunnel mapping.
The options are as follows:
-
-C circuit-id -
The circuit-id relay agent information sub-option value that
dhcrelayshould append on relayed packets. If this option is not specified, it will use the interface number by default. -
-d -
Do not daemonize. If this option is specified,
dhcrelaywill run in the foreground and log to stderr. -
-i interface -
The name of the network interface that
dhcrelayshould attempt to configure. For layer 3 mode at least one IPv4 address has to be configured on this interface. -
-o -
Add the relay agent information option. By default, this is only enabled for the enc(4) interface.
-
-R remote-id -
The remote-id relay agent information sub-option value that
dhcrelayshould append on relayed packets. If this option is not specified, it will use the destination address by default. -
-r -
Replace incoming Relay Agent Information with the one configured.
Releases
58 releases since OpenBSD 2.4; the text changed 17 times.
- 2.4–2.5
- 2.6
- 2.7–2.9
- 3.0–3.1
- 3.2
- 3.3
- 3.4–3.5
- 3.6–3.8
- 3.9–4.1
- 4.2–4.6
- 4.7–4.8
- 4.9–5.2
- 5.3
- 5.4–6.0
- 6.1–7.0
- 7.1–7.2
- 7.3–7.5
- 7.6–8.0
-C since OpenBSD 6.1;
-R since OpenBSD 6.1;
-d since OpenBSD 3.6;
-i since OpenBSD 3.6;
-o since OpenBSD 4.7;
-r since OpenBSD 6.1.