Files
linamh/net-misc/ipx-utils/files/ipx.confd
Mario Fetka a1490efb03 add samples
2026-04-19 23:08:28 +02:00

141 lines
3.9 KiB
Plaintext

# 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="
"