# Copyright 1999-2026 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2

# Configuration for the IPX network startup helpers.
#
# This file is used by:
#   - /etc/init.d/ipx
#   - /usr/libexec/ipx/network-start.sh
#   - /usr/libexec/ipx/network-stop.sh
#   - /etc/systemd/system/ipx.service
#
# Manual interface configuration:
#   IPX_INTERFACES contains one entry per line.
#
# Format:
#   <device>:<frame>:<netnum>
#
# Example:
#   IPX_INTERFACES="
#   enp0s31f6:802.2:1
#   enp46s0u1u3u3:802.2:2
#   wlp0s20f3:802.2:3
#   "
#
# Behaviour:
#   - The first successfully configured interface becomes the primary IPX
#     interface.
#   - Additional interfaces are configured as non-primary interfaces.
#   - Each manually configured interface should use its own IPX network
#     number.
#   - Interfaces that are not currently present are skipped with a warning.
#   - This is useful for optional hardware such as a docking station NIC.
#
# Link-state handling:
#   If IPX_SKIP_LINK_DOWN=yes, interfaces that exist but currently do not
#   have an active link are skipped as well.
#
# This is useful for cases such as:
#   - a docking station NIC that exists but currently has no link
#   - a physical Ethernet device with no cable attached
#
# Detection order:
#   1. /sys/class/net/<if>/carrier
#   2. /sys/class/net/<if>/operstate
#
# Example with an optional docking station interface:
#   IPX_INTERFACES="
#   enp46s0u1u3u3:802.2:1
#   enp0s31f6:802.2:2
#   wlp0s20f3:802.2:3
#   "
#
# In that example:
#   - if enp46s0u1u3u3 is present and usable, it will be configured first
#     and become the primary IPX interface
#   - if enp46s0u1u3u3 is missing, it will be skipped
#   - if enp46s0u1u3u3 exists but has no active link and
#     IPX_SKIP_LINK_DOWN=yes, it will also be skipped
#   - the next successfully configured interface will become primary
#
# Static route configuration:
#   IPX_ROUTES contains one entry per line.
#
# Format:
#   <target_network>:<router_network>:<router_node>
#
# Example:
#   IPX_ROUTES="
#   00000010:00000001:508140F6AC45
#   00000020:00000003:44E517C3D034
#   "
#
# Route behaviour:
#   - Routes are added after all interfaces have been configured
#   - During shutdown, routes are removed again by target network
#   - Empty lines and comment lines starting with '#' are ignored
#
# Automatic configuration:
#   IPX_AUTO_PRIMARY and IPX_AUTO_INTERFACE are passed to ipx_configure.
#
# Recommended setting for manual interface definitions:
#   - IPX_AUTO_INTERFACE=off
#
# This avoids mixing manual interface definitions with automatically created
# IPX interfaces.
#
# Internal network mode:
#   If IPX_INTERNAL_NET=yes, no physical interfaces from IPX_INTERFACES are
#   configured.
#
#   Instead, an IPX internal network is created using IPX_NETNUM and
#   IPX_NODENUM.
#
#   The internal network does not use a physical device or frame type and
#   automatically becomes the primary IPX interface.
#
#   There can only be one internal network per host.

# Automatically select a primary IPX interface.
IPX_AUTO_PRIMARY=on

# Automatically create IPX interfaces.
# Recommended: off when using IPX_INTERFACES.
IPX_AUTO_INTERFACE=off

# Skip interfaces that are present but currently have no active link.
# Valid values: yes / no
IPX_SKIP_LINK_DOWN=yes

# Create a special internal IPX network instead of binding to physical NICs.
# Valid values: yes / no
IPX_INTERNAL_NET=no

# IPX network number for internal network mode only.
IPX_NETNUM=1

# IPX node number for internal network mode only.
IPX_NODENUM=1

# Manually configured IPX interfaces.
# Format: <device>:<frame>:<netnum>
#
# The first successfully configured interface becomes primary.
# Missing interfaces are skipped.
IPX_INTERFACES="
enp46s0u1u3u3:802.2:1
enp0s31f6:802.2:2
wlp0s20f3:802.2:3
"

# Static IPX routes.
# Format: <target_network>:<router_network>:<router_node>
#
# Example:
# IPX_ROUTES="
# 00000010:00000001:508140F6AC45
# 00000020:00000003:44E517C3D034
# "
IPX_ROUTES="
"