slackware-current/source/n/network-scripts/manpages/rc.inet1.8
Patrick J Volkerding 07ac5d43e5 Mon Mar 1 20:10:44 UTC 2021
a/e2fsprogs-1.46.2-x86_64-1.txz:  Upgraded.
a/etc-15.0-x86_64-14.txz:  Rebuilt.
  /etc/hosts: added IPv6 loopback addresses.
a/hwdata-0.345-noarch-1.txz:  Upgraded.
ap/hplip-3.20.6-x86_64-7.txz:  Rebuilt.
  Fixed desktop file to show category and icon properly.
  Thanks to upnort and ArTourter.
d/git-2.30.1-x86_64-3.txz:  Rebuilt.
  Make sure the bash-completion file is installed in the proper location.
  Thanks to Robby Workman.
d/python-setuptools-54.0.0-x86_64-1.txz:  Upgraded.
d/vala-0.50.4-x86_64-1.txz:  Upgraded.
l/imagemagick-7.0.11_2-x86_64-1.txz:  Upgraded.
l/python-pillow-8.1.1-x86_64-1.txz:  Upgraded.
n/network-scripts-15.0-noarch-13.txz:  Rebuilt.
  Well, apparently there was a newer branch of this than the one that was
  sitting in my usual pending queue, so here it is. This also includes some
  additional documentation on the new features. NOTE: In order to use SLAAC
  to configure IPv6, you'll need to have USE_SLAAC[x]="yes" for the interface
  in rc.inet1.conf. This is to ensure that nobody is surprised to find their
  machine fully exposed to the internet - better safe than sorry.
  Thanks to Darren "Tadgy" Austin and Robby Workman.
n/wireless_tools-30.pre9-x86_64-4.txz:  Rebuilt.
  This package contains some updates to rc.wireless and rc.wireless.conf.
  Thanks to Darren "Tadgy" Austin.
xfce/mousepad-0.5.3-x86_64-1.txz:  Upgraded.
2021-03-02 08:59:52 +01:00

120 lines
3.4 KiB
Groff

.\" -*- nroff -*-
.ds g \" empty
.ds G \" empty
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.el .TP "\\$1"
..
.TH RC.INET1 8 "1 Oct 2018" "Slackware Version 15.0"
.SH NAME
rc.inet1 \- Slackware network configuration script.
.SH DESCRIPTION
.BR rc.inet1 .
This script configures network interfaces.
Wireless interfaces are configured just like any network device
but accept many more configuration parameters.
.LP
rc.inet1 reads its configuration parameters from a file
.IR /etc/rc.d/rc.inet1.conf .
The
.I rc.inet1.conf
file contains a series of variable array definitions,
with each array index corresponding to a single network interface.
.SH OPTIONS
The way to start your network (configuring your nics and
bringing the interfaces up, and creating a default route if required)
is by running the command:
.LP
.B /etc/rc.d/rc.inet1 start
.LP
Restarting the whole network (all available network interfaces)
is done in a similar fashion:
.LP
.B /etc/rc.d/rc.inet1 restart
.LP
More generally speaking, you can start/stop/restart any network
interface by running one of the commands:
.LP
.B /etc/rc.d/rc.inet1 INTERFACE_start
.LP
.B /etc/rc.d/rc.inet1 INTERFACE_stop
.LP
.B /etc/rc.d/rc.inet1 INTERFACE_restart
.LP
where
.B INTERFACE
is the name of an existing network interface (eth0, wlan0, ...)
.SH WIRELESS
The script
.I rc.wireless
takes care of configuring the wireless parameters for a network
interface. This script does not run independently. Instead, it is executed
by the generic network configuration script
.IR rc.inet1 .
.LP
If a wireless interface is detected,
.I rc.wireless
will use
.IR iwconfig ,
.I iwpriv
and possibly
.I wpa_supplicant
to associate the card with an access point (in managed mode) or peer it with
another computer (in ad-hoc mode), and enable an encryption modus like WPA.
.SH FILES
.TP 25
.I /etc/rc.d/rc.inet1
network configuration script
.TP
.I /etc/rc.d/rc.inet1.conf
parameter definition file (is being read by rc.inet1 and rc.wireless)
.TP
.I /etc/rc.d/rc.wireless
wireless configuration script
.TP
.I /etc/rc.d/rc.wireless.conf
parameter definition file (
.B deprecated
)
.SH DIAGNOSTICS
If you remove the executable bit from the
.I rc.wireless
script, it will never be executed. This can be beneficial if you have
written your own wireless script and don't want Slackware to mess it up.
.SH CAVEATS
The network interface definitions are stored in variable
.I arrays.
The bash shell has no facilities to retrieve the largest array index used.
Therefore, the
.I rc.inet1
script makes the assumption that array indexes stay below the value of
.BR 6 .
Effectively this means that you can configure up to 6 network interfaces in
rc.inet1.conf by default.
.LP
If you want to configure more than six network interfaces, you will
have to edit the file
.I /etc/rc.d/rc.inet1.conf
and change the value `6' in the line:
.br
.B \ \ #MAXNICS="6"
.br
(at the very bottom of the file) to a value that is larger than the largest
index value you use, and uncomment the line.
.LP
The /etc/rc.d/rc.wireless script is not meant to be run on its own by the user!
.SH AUTHORS
Patrick J. Volkerding <volkerdi@slackware.com>
.br
Eric Hameleers <alien@slackware.com>
.br
Robby Workman <rworkman@slackware.com>
.br
Darren 'Tadgy' Austin <darren@slackware.uk>
.SH "SEE ALSO"
.BR rc.inet1.conf(5),
.BR ip(8),
.BR iwconfig(8),
.BR route(8)