45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# `add_canned_isp` Command
|
|
|
|
## Name
|
|
|
|
`add_canned_isp`
|
|
|
|
## Synopsis
|
|
|
|
```
|
|
add_canned_isp ${interface} ${custom_name} ${isp_name}
|
|
```
|
|
|
|
## Description
|
|
|
|
Adds and configures an upstream ISP's connection interface. This attempts to
|
|
provision the connection as dual stack, both IPv4 and IPv6. Interfaces that
|
|
are external cannot also be internal. ISP interfaces will be added to the
|
|
`external` interface group, for ease of reference in `pf.conf` firewall rules.
|
|
|
|
The specified `${interface}` will be provisioned for ISP uplink, according to
|
|
the specified `${isp_name}` configuration rules.
|
|
|
|
The `${custom_name}` parameter provides a user-defined name for a specific ISP
|
|
link, which can be used with the `isp=...` options of [`add_net`](add_net.md) and
|
|
related scripts. It can be the same as `${isp_name}` but it does not have to be.
|
|
|
|
The `${isp_name}` references ISP "hints" files in `${rc_router_dir}/hints` and
|
|
`${rc_router_conf_dir}/hints`. The latter of which can be populated with
|
|
user-defined ISP hints.
|
|
|
|
ISPs are always configured as `dhcp` for IPv4. For custom static provisioning,
|
|
other methods of provisioning these interfaces can be used.
|
|
|
|
## Example
|
|
```
|
|
# Connect to Verizon FIOS over `abc0`, and name the connection `main_isp`.
|
|
add_canned_isp abc0 main_isp verizon_fios
|
|
```
|
|
|
|
## See Also
|
|
|
|
- [`add_net`](add_net.md)
|
|
- [`add_vlan`](add_vlan.md)
|
|
- [`clone_interface`](clone_interface.md)
|