Skip to content

Commit

Permalink
network/index: Multiple changes.
Browse files Browse the repository at this point in the history
* Include text from `interface-names.md`, `static.md` and `dhcpcd.md`.
* Remove those files.
* Change relevant links in `connman.md` and `networkmanager.md`.
* Mention `rfkill(8)`.
* Refer to wireless subsections.
* Improve prose.
* Fix formatting.
  • Loading branch information
flexibeast committed Jun 19, 2020
1 parent b7a2f0e commit 55bc576
Show file tree
Hide file tree
Showing 7 changed files with 61 additions and 53 deletions.
3 changes: 0 additions & 3 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,6 @@
- [Date and Time](./config/date-time.md)
- [Kernel](./config/kernel.md)
- [Network](./config/network/index.md)
- [Interface Names](./config/network/interface-names.md)
- [Static Configuration](./config/network/static.md)
- [dhcpcd](./config/network/dhcpcd.md)
- [iptables](./config/network/iptables.md)
- [wpa_supplicant](./config/network/wpa_supplicant.md)
- [iwd](./config/network/iwd.md)
Expand Down
2 changes: 1 addition & 1 deletion src/config/network/connman.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ possible. The `connman` package contains the basic utilities to run ConnMan.
## Starting ConnMan

To enable the ConnMan daemon, first [disable](../services/index.md) any other
network managing services like [dhcpcd](./dhcpcd.md),
network managing services like [dhcpcd](./index.md#dhcpcd),
[wpa_supplicant](./wpa_supplicant.md), or `wicd`. These services all control
network interface configuration, and interfere with each other.

Expand Down
22 changes: 0 additions & 22 deletions src/config/network/dhcpcd.md

This file was deleted.

60 changes: 57 additions & 3 deletions src/config/network/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,59 @@
# Network

Network configuration in Void Linux can be done with different methods. The
default installation comes with the
[dhcpcd(8)](https://man.voidlinux.org/dhcpcd.8) service enabled.
Network configuration in Void Linux can be done in several ways. The default
installation comes with the [dhcpcd(8)](https://man.voidlinux.org/dhcpcd.8)
service enabled.

## Interface Names

Newer versions of [udev(7)](https://man.voidlinux.org/udev.7) no longer use the
traditional Linux naming scheme for interfaces (`eth0`, `eth0`, `wlan0`, ...).

This behavior can be reverted by adding `net.ifnames=0` to the [kernel
cmdline](../kernel.md#cmdline).

## Static Configuration

A simple way to configure a static network at boot is to add the necessary
[ip(8)](https://man.voidlinux.org/ip.8) commands to the `/etc/rc.local` file:

```
ip link set dev eth0 up
ip addr add 192.168.1.2/24 brd + dev eth0
ip route add default via 192.168.1.1
```

## dhcpcd

To run [dhcpcd(8)](https://man.voidlinux.org/dhcpcd.8) on all interfaces, enable
the `dhcpcd` service.

To run `dhcpcd` only on a specific interface, copy the `dhcpcd-eth0` service and
modify it to match your interface:

```
$ ip link show
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT group default qlen 1
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
2: enp3s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP mode DEFAULT group default qlen 1000
link/ether ff:ff:ff:ff:ff:ff brd ff:ff:ff:f
# cp -R /etc/sv/dhcpcd-eth0 /etc/sv/dhcpcd-enp3s0
# sed -i 's/eth0/enp3s0/' /etc/sv/dhcpcd-enp3s0/run
# ln -s /etc/sv/dhcpcd-enp3s0 /var/service/
```

For more information on configuring `dhcpcd`, refer to
[dhcpcd.conf(5)](https://man.voidlinux.org/dhcpcd.conf.5)

## Wireless

Before using wireless networking, use
[rfkill(8)](https://man.voidlinux.org/rfkill.8) to check whether the relevant
interfaces are soft- or hard-blocked.

Void provides several ways to connect to wireless networks:

- [wpa_supplicant](./wpa_supplicant.md)
- [iwd](./iwd.md)
- [NetworkManager](./networkmanager.md)
- [ConnMan](./connman.md)
7 changes: 0 additions & 7 deletions src/config/network/interface-names.md

This file was deleted.

6 changes: 3 additions & 3 deletions src/config/network/networkmanager.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ package contains the basic utilities to run

To enable the [NetworkManager(8)](https://man.voidlinux.org/NetworkManager.8)
daemon, first [disable](../services/index.md) any other network managing
services like [dhcpcd](./dhcpcd.md), [wpa_supplicant](./wpa_supplicant.md), or
`wicd`. These services all control network interface configuration, and
interfere with each other.
services like [dhcpcd](./index.md#dhcpcd),
[wpa_supplicant](./wpa_supplicant.md), or `wicd`. These services all control
network interface configuration, and interfere with each other.

Also, ensure that the `dbus` service is [enabled](../services/index.md) and
running. [NetworkManager(8)](https://man.voidlinux.org/NetworkManager.8) uses
Expand Down
14 changes: 0 additions & 14 deletions src/config/network/static.md

This file was deleted.

0 comments on commit 55bc576

Please sign in to comment.