Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

network/index: Multiple changes. #336

Merged
merged 1 commit into from
Jun 19, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,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.