summaryrefslogtreecommitdiff
path: root/interface-definitions/dhcp-relay.xml.in
blob: 746cc2fb48909b99aa6dcf473ca45e61e97c60fb (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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<?xml version="1.0"?>
<!-- DHCP relay configuration -->
<interfaceDefinition>
  <node name="service">
    <children>
      <node name="dhcp-relay" owner="${vyos_conf_scripts_dir}/dhcp_relay.py">
        <properties>
          <help>Host Configuration Protocol (DHCP) relay agent</help>
          <priority>910</priority>
        </properties>
        <children>
          <leafNode name="interface">
            <properties>
              <help>Interface Name to use [To be deprecated]. Only for backward compatibility. Use listen-interface and upstream-interface instead of this option </help>
              <completionHelp>
                <script>${vyos_completion_dir}/list_interfaces.py --broadcast</script>
              </completionHelp>
              <valueHelp>
                <format>txt</format>
                <description>Interface name</description>
              </valueHelp>
              <constraint>
                <validator name="interface-name"/>
              </constraint>
              <multi/>
            </properties>
          </leafNode>
          <leafNode name="listen-interface">
            <properties>
              <help>Interface for DHCP Relay Agent to listen for requests</help>
              <completionHelp>
                <script>${vyos_completion_dir}/list_interfaces.py</script>
              </completionHelp>
              <valueHelp>
                <format>txt</format>
                <description>Interface name</description>
              </valueHelp>
              <constraint>
                <validator name="interface-name"/>
              </constraint>
              <multi/>
            </properties>
          </leafNode>
          <leafNode name="upstream-interface">
            <properties>
              <help>Interface for DHCP Relay Agent forward requests out</help>
              <completionHelp>
                <script>${vyos_completion_dir}/list_interfaces.py</script>
              </completionHelp>
              <valueHelp>
                <format>txt</format>
                <description>Interface name</description>
              </valueHelp>
              <constraint>
                <validator name="interface-name"/>
              </constraint>
              <multi/>
            </properties>
          </leafNode>
          <node name="relay-options">
            <properties>
              <help>Relay options</help>
            </properties>
            <children>
              <leafNode name="hop-count">
                <properties>
                  <help>Policy to discard packets that have reached specified hop-count</help>
                  <valueHelp>
                    <format>u32:1-255</format>
                    <description>Hop count</description>
                  </valueHelp>
                  <constraint>
                    <validator name="numeric" argument="--range 1-255"/>
                  </constraint>
                  <constraintErrorMessage>hop-count must be a value between 1 and 255</constraintErrorMessage>
                </properties>
                <defaultValue>10</defaultValue>
              </leafNode>
              <leafNode name="max-size">
                <properties>
                  <help>Maximum packet size to send to a DHCPv4/BOOTP server</help>
                  <valueHelp>
                    <format>u32:64-1400</format>
                    <description>Maximum packet size</description>
                  </valueHelp>
                  <constraint>
                    <validator name="numeric" argument="--range 64-1400"/>
                  </constraint>
                  <constraintErrorMessage>max-size must be a value between 64 and 1400</constraintErrorMessage>
                </properties>
                <defaultValue>576</defaultValue>
              </leafNode>
              <leafNode name="relay-agents-packets">
                <properties>
                  <help>Policy to handle incoming DHCPv4 packets which already contain relay agent options</help>
                  <completionHelp>
                    <list>append replace forward discard</list>
                  </completionHelp>
                  <valueHelp>
                    <format>append</format>
                    <description>append own relay options to packet</description>
                  </valueHelp>
                  <valueHelp>
                    <format>replace</format>
                    <description>replace existing agent option field</description>
                  </valueHelp>
                  <valueHelp>
                    <format>forward</format>
                    <description>forward packet unchanged</description>
                  </valueHelp>
                  <valueHelp>
                    <format>discard</format>
                    <description>discard packet (default action if giaddr not set in packet)</description>
                  </valueHelp>
                  <constraint>
                    <regex>(append|replace|forward|discard)</regex>
                  </constraint>
                </properties>
                <defaultValue>forward</defaultValue>
              </leafNode>
            </children>
          </node>
          <leafNode name="server">
            <properties>
              <help>DHCP server address</help>
              <valueHelp>
                <format>ipv4</format>
                <description>DHCP server IPv4 address</description>
              </valueHelp>
              <multi/>
              <constraint>
                <validator name="ipv4-address"/>
              </constraint>
            </properties>
          </leafNode>
        </children>
      </node>
    </children>
  </node>
</interfaceDefinition>