2 ###############################################################################
4 # IPFire.org - A linux based firewall #
5 # Copyright (C) 2012 IPFire Network Development Team #
7 # This program is free software: you can redistribute it and/or modify #
8 # it under the terms of the GNU General Public License as published by #
9 # the Free Software Foundation, either version 3 of the License, or #
10 # (at your option) any later version. #
12 # This program is distributed in the hope that it will be useful, #
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of #
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
15 # GNU General Public License for more details. #
17 # You should have received a copy of the GNU General Public License #
18 # along with this program. If not, see <http://www.gnu.org/licenses/>. #
20 ###############################################################################
22 .
/usr
/lib
/network
/header-zone
24 HOOK_SETTINGS
="HOOK ACCESS_CONCENTRATOR AUTH USERNAME PASSWORD"
25 HOOK_SETTINGS
="${HOOK_SETTINGS} SERVICE_NAME MTU IPV6 PREFIX_DELEGATION"
27 # User credentials for the dialin.
31 # Set the authentication mechanism.
34 # Access Concentrator.
35 ACCESS_CONCENTRATOR
=""
40 # Maximum Transmission Unit.
41 # 1492 is a very common value for that.
44 # This hook can work with all authentication methods supported by pppd.
45 PPPOE_SUPPORTED_AUTH_METHODS
="${PPP_SUPPORTED_AUTH_METHODS}"
46 PPPOE_PLUGIN
="rp-pppoe.so"
48 # Request an IPv6 address.
51 # Use IPv6 prefix delegation.
52 PREFIX_DELEGATION
="false"
54 function hook_check
() {
58 isset AUTH
&& assert isoneof AUTH
${PPPOE_SUPPORTED_AUTH_METHODS}
61 assert isset PREFIX_DELEGATION
64 function hook_parse_cmdline
() {
65 while [ $# -gt 0 ]; do
67 --access-concentrator=*)
68 ACCESS_CONCENTRATOR
=$
(cli_get_val
${1})
71 AUTH
=$
(cli_get_val
${1})
74 local value
="$(cli_get_val "${1}")"
75 if enabled value
; then
82 MTU
=$
(cli_get_val
${1})
85 PASSWORD
=$
(cli_get_val
${1})
87 --prefix-delegation=*)
88 PREFIX_DELEGATION
="$(cli_get_bool "${1}")"
91 SERVICE_NAME
=$
(cli_get_val
${1})
94 USERNAME
=$
(cli_get_val
${1})
97 warning
"Unknown argument: ${1}" >&2
108 zone_settings_read
"${zone}" ${HOOK_SETTINGS}
111 local port
=$
(__hook_get_port
"${zone}")
114 # Start the ppp daemon.
120 function hook_down
() {
124 zone_settings_read
"${zone}" ${HOOK_SETTINGS}
126 # Stop the ppp daemon.
129 # Bring down the port.
130 log DEBUG
"Bringing down port '${PORT}'."
136 function hook_discover
() {
139 if [ "$(device_get_type ${device})" != "real" ]; then
144 output
=$
(pppoe-discovery
-I ${device} -U $
(uuid
) 2>&1)
146 # Exit if there was not output
147 [ -z "${output}" ] && exit ${DISCOVER_ERROR}
149 # Exit if PADI timed out
150 grep -q "Timeout" <<<${output} && exit ${DISCOVER_ERROR}
155 Access-Concentrator
:*)
156 ac
="${line#Access-Concentrator: }"
161 echo "ACCESS_CONCENTRATOR=\"$ac\""
166 function hook_status
() {
170 cli_device_headline
${zone}
172 zone_settings_read
"${zone}" ${HOOK_SETTINGS}
174 cli_headline
2 "Configuration"
175 cli_print_fmt1
2 "Username" "${USERNAME}"
176 cli_print_fmt1
2 "Password" "<hidden>"
178 local port
=$
(__hook_get_port
"${zone}")
180 cli_print_fmt1
2 "Port" "${port}"
184 # Exit if zone is down
185 if ! zone_is_up
${zone}; then
190 # XXX display time since connection started
192 cli_headline
2 "Point-to-Point-over-Ethernet protocol"
194 for proto
in ${IP_SUPPORTED_PROTOCOLS}; do
195 routing_db_exists
${zone} ${proto} ||
continue
200 headline
="Internet Protocol Version 6"
203 headline
="Internet Protocol Version 4"
206 headline
="Unkown protocol"
209 cli_headline
3 "${headline}"
211 cli_print_fmt1
3 "IP address" "$(routing_db_get ${zone} ${proto} local-ip-address)"
212 cli_print_fmt1
3 "Gateway" "$(routing_db_get ${zone} ${proto} remote-ip-address)"
213 cli_print_fmt1
3 "DNS servers" "$(routing_db_get ${zone} ${proto} dns)"
215 cli_print_fmt1
3 "MAC-Remote" "$(routing_db_get ${zone} ${proto} remote-address)"
222 function hook_ppp_write_config
() {
229 # Read in the configuration files.
230 zone_settings_read
"${zone}" ${HOOK_SETTINGS}
232 # A port has to be assigned for this action
233 local port
=$
(__hook_get_port
"${zone}")
234 if ! isset port
; then
235 error
"No port assigned to pppoe hook of zone '${zone}'"
239 # Prepare the command line options for the pppoe plugin.
242 # Add the access concentrator (if any).
243 if isset ACCESS_CONCENTRATOR
; then
244 plugin_options
="${plugin_options} rp_pppoe_ac '${ACCESS_CONCENTRATOR}'"
247 # Add the service name (if any).
248 if isset SERVICE_NAME
; then
249 plugin_options
="${plugin_options} rp_pppoe_service '${SERVICE_NAME}'"
252 # The last argument must be the interface.
253 plugin_options
="${plugin_options} ${port}"
255 pppd_write_config
${file} \
256 --interface="${zone}" \
257 --username="${USERNAME}" \
258 --password="${PASSWORD}" \
263 --plugin="${PPPOE_PLUGIN}" \
264 --plugin-options="${plugin_options}"
269 function __hook_get_port
() {
273 for port
in $
(zone_get_ports
"${zone}"); do
281 function hook_port_add
() {
282 # Excepting at least two arguments here
289 # PPPoE can only use one port
290 local ports_num
="$(zone_get_ports_num "${zone}")"
291 if [ ${ports_num} -ge 1 ]; then
292 local port
=$
(__hook_get_port
"${zone}")
293 error
"The pppoe zone hook only supports assigning one port"
294 error
" port '${port}' has already been assigned to zone '${zone}'"
298 zone_port_settings_write
"${zone}" "${port}"
299 log INFO
"Port '${port}' has been added to zone '${zone}'"
304 function hook_port_remove
() {
310 # Shut down the port (if possible)
313 log INFO
"Port '${port}' has been removed from zone '${zone}'"
314 zone_port_settings_remove
"${zone}" "${port}"