Handbook Talk:Parts/Installation/Networking

Missing Path template

Talk status

This discussion is done as of 2017-05-15.

In the following sentence there's a missing Path template around wlan0:

In the above example, 6 interfaces are found. The eth0 one is most likely the (wired) Ethernet adapter whereas wlan0 is the wireless one.

Fturco (talk) 15:20, 13 May 2017 (UTC)

Fixed! --Maffblaster (talk) 18:38, 15 May 2017 (UTC)

Missing whitespace

Talk status

This discussion is done as of 2017-05-15.

In the following sentence there's a missing whitespace between working, and continue:

"Once wireless is working,continue configuring the IP level networking options as described in the next section (Understanding network terminology) or use the net-setup tool as described previously."

Fturco (talk) 15:26, 13 May 2017 (UTC)

Fixed! --Maffblaster (talk) 18:38, 15 May 2017 (UTC)

iw dev wlp9s0 connect -w GentooNode key 0:d:1234123412341234abcd wrong

Talk status

This discussion is still ongoing.

key must be [d:]index:data where
  'd:'      means default (transmit) key
  'index:'  is a single digit (0-3)
  'data'    must be 5 or 13 ascii char
            or 10 or 26 hex digits
for example: d:2:6162636465 is the same as d:2:abcde

i'am wired man, but other sites provide examples:

http://linuxwireless.org/en/users/Documentation/iw/ https://wireless.wiki.kernel.org/en/users/documentation/iw/replace-iwconfig iw wlan0 connect foo keys 0:abcde d:1:0011223344 --Cronolio (talk) 09:21, 23 May 2017 (UTC)

HTTPS link

Talk status

This discussion is done as of 2023-07-15.

The following link should use HTTPS instead of plain HTTP: http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/ -- Fturco (talk) 14:12, 3 June 2020 (UTC)

Fixed. See Special:Diff/1214258/1251623. Thanks! --Maffblaster (talk) 23:17, 15 July 2023 (UTC)

File location

Talk status

This discussion is done as of 2023-07-15.

The following file location lacks a leading slash: etc/ppp/pap-secrets. -- Fturco (talk) 14:19, 3 June 2020 (UTC)

Fixed! Thank you! See Special:Diff/1251625/1251630. --Maffblaster (talk) 23:49, 15 July 2023 (UTC)

Another missing Path template

Talk status

This discussion is done as of 2023-07-15.

Consider the following sentence: "Some wireless cards may have a device name of wlan0 or ra0 instead of wlp9s0." We should add a Path template around "wlp9s0". -- Fturco (talk) 14:30, 3 June 2020 (UTC)

Fixed for consistency: Special:Diff/1251623/1251625. Thanks! --Maffblaster (talk) 23:22, 15 July 2023 (UTC)

Warning

Talk status

This discussion is done as of 2023-07-15.

There is a warning on this page: "Do not try to follow instructions directly from the Handbook:Parts namespace (WHICH THIS PAGE!), or any of its sub-pages. The Handbook:Parts is a meta handbook used for transcluding text into other Handbooks. Use the architecture-specific Handbooks found in the Handbook list for complete installation instructions." It is very long and difficult to understand. If it is really important, it should be short and simple. What is the message here? How can we shorten it and focus on the gist? --Jonas Stein (talk) 16:06, 25 March 2023 (UTC)

The warning text can be revises, but I'm not sure how to word it better. The gist is to warn our users to not read Handbook:Parts directly, but read the architecture-specific handbook pages. The architecture specific handbooks are built by transcluding different sections of a base Handbook (Handbook:Parts) into them and do not include the details needed for specific computer architectures. Handbook:Parts can be thought of like an eclass: it is consumed by each Handbook:<ARCH>, but is not useful to the reader by itself... adjusted here: Special:Diff/1214682/1251628. --Maffblaster (talk) 23:31, 15 July 2023 (UTC)

Let's move "Understanding network terminology"

Talk status

This discussion is done as of 2023-07-15.

Understanding network terminology is a good general introduction into IPv4, netmasks and so on, but it does not belong into the handbook. Any objections to move this subsection to a separate wiki page? --Jonas Stein (talk) 18:07, 25 March 2023 (UTC)

Sounds good to me. I think moving it near the top of the existing Network management article is likely the best place for it. Please provide a link for our readers to the target once it has been moved. Thank you! --Maffblaster (talk) 23:56, 15 July 2023 (UTC)

ip and ifconfig

Talk status

This discussion is done as of 2023-07-15.

We switch between the old ifconfig and the modern, more powerful ip command. Should we unify it to ip and simply add a sentence about the difference? --Jonas Stein (talk) 21:19, 25 March 2023 (UTC)

I hear ifconfig is even getting deprecated on some distributions, so sounds good to me. -- Ris (talk) 07:33, 28 March 2023 (UTC)

Sounds good to me as well. It is an important part of the handbook to provide manual network configuration, since part of what we're doing is teaching about the userspace tools available natively with the Gentoo environment. --Maffblaster (talk) 23:58, 15 July 2023 (UTC)

replace ifconfig and route

Talk status

This discussion is still ongoing.

While talking about route and ifconfig in IRC #gentoo-wiki, floppym additionally suggested to remove the route and ifconfig commands for good and use iproute2 only. Yes, I think the same and support that idea too. It is your descission. However for me, more imporant is the usage of iproute2 after all, and that it is shown as the prefered tool for linux IP configuration. After reading the Networking part, I noticed MAC addressess are different some things are not consistent if looking deep into the shown networking details. I could prepare the needed output for the most obvious sections, so it is concise. I leave that IP addressing as it is, since it is exaclty eplained in a example at the bottom of that Netwokring wiki page. What do you think about this? Needle (talk) 23:02, 6 July 2023 (UTC)