ACC SHELL

Network configuration
=====================
Michal Svec <msvec@suse.cz>

This document describes the new concept of the network configuration
in sysconfig. It contains description of directory structure, used
utilities, configuration files format and particular variables.

Directory structure
-------------------

/etc/sysconfig/				main config dir

/etc/sysconfig/network/			main network config dir
/etc/sysconfig/network/scripts/		network config scripts
/etc/sysconfig/network/providers/	providers definitions

Scripts
-------
/etc/init.d/network			overall network manipulation
/sbin/rcnetwork				symlink -> /etc/init.d/network

/sbin/ifup				set up the interface
/sbin/ifdown				shut down the interface
/sbin/ifstatus				show the interface status

ifup-ppp				set up ppp (modem) interface
ifup-isdn				set up isdn (or ippp) interface

ifup-dhcp				set up interface via dhcp

ifup-routes				set up (interface) routes

Script details and syntax
-------------------------
By default, all "rcnetwork start" scripts work only
with configured interfaces ("configured" means no STARTMODE=onboot). If one
needs to setup particular interface, he should do it explicitely.

rcnetwork {start|stop|restart|reload|status}
- start:	set up all configured devices
- stop:		shut down all active devices
- restart:	stop and start
- reload:	stop and start for all interfaces that changed
- status:	show current network devices status

ifup config [interface] [-o options]
- set up given interface
- if config file doesn't contain interface its required as an argument
- option 'onboot' -> activate during boot
- option 'hotplug' -> activated by hotplug

ifdown config [interface]
- shut down the given interface

ifstatus config [interface]
- show given interface status

ifup-ppp
ifup-isdn
ifup-dhcp
ifup-routes

Config files
------------

/etc/sysconfig/network/config		main network configuration
/etc/sysconfig/network/dhcp		dhcp client settings
/etc/sysconfig/isdn			isdn configuration
/etc/sysconfig/proxy			proxy configuration

/etc/sysconfig/network/ifcfg-eth0	1st ethernet configuration
/etc/sysconfig/network/ifcfg-tr0	1st token-ring configuration
/etc/sysconfig/network/ifcfg-plip0	1st parallel line configuration

Common variables
----------------

See the ifcfg(5) manual page - more specific informations are
also in the ifcfg-bonding(5), ifcfg-bridge(5), ifcfg-tunnel(5),
ifcfg-vlan(5), ifcfg-wireless(5) manual pages.

Additional modem configuration variables
----------------------------------------

MODEM_DEVICE	"/dev/ttyS0"
- modem device

SPEED		"115200"
- modem speed in bauds

DIALCOMMAND	"ATDP"
- dialing command (ATDT|ATDP)

INIT1		"AT&F"
INIT2		"AT\N10%P1"
INIT3		""
- modem init strings

INIT8		"ATM0"
- detect carrier

INIT9		"ATX3"
- speaker on

DIALPREFIX	"0"
- optional dialing prefix

PPPD_OPTIONS	""
- additional pppd(8) options

PROVIDER	"provider0"
- default provider file name without path

Additional isdn configuration variables
---------------------------------------

MULTILINK	"no"
CHARGEHUP	"no"
MSN		"21"
SLAVES		""

LAYER2		"hdlc"
LAYER3		"trans"
ENCAP		"syncppp"
IP_RESEND	"no"
IP_RESEND_OPTIONS
COMPRESSION	""

IPPPD_OPTIONS	""
- additional ipppd(8) options

Additional dsl configuration variables
--------------------------------------

DEVICE		"eth0"
- ethernet device for pppoe

VPIVCI		""
- VPI/VCI number for pppoatm

Provider configuration
----------------------

PROVIDER	"Arcor"
- provider name

PRODUCT		"Internet-by-Call"
- product name

HOMEPAGE	"http://www.arcor.de"
- provider home page

PHONE		"010700192070"
- phone number

USERNAME	"arcor"
- user name

PASSWORD	"internet"
- password

IDLETIME	"300"
- time before the connection is automatically disconnected (0 is off)

DEMAND		"no"
- dial on demand

MODIFYDNS	"no"
- modify DNS after connect

MODIFYIP	"no"
- modify IP addresses after connect

ASKPASSWORD	"no"
- always ask for password before connect

DNS1		"145.253.2.11"
- first name server

DNS2		"145.253.2.75"
- second name server

STUPIDMODE	"yes"
- look for user/pass strings, see wvdial(1)

COMPUSERVE	"no"
- special wvdial(1) compuserve mode

DEFAULTROUTE	"yes"
- set default route after dial

PPPMODE		"ppp"|"ippp"|"pppoe"|"pppoatm"|...
- PPP connection type

PRIORITY	"0"
- provider priority

MODEMSUPPORTED	"yes"
- provider supports modem dialup

ISDNSUPPORTED	"yes"
- provider supports ISDN dialup

DSLSUPPORTED	"yes"
- provider supports DSL dialup

COUNTRY		"Germany"
- provider country

EOF