diff options
Diffstat (limited to 'documentation/content/en/books/handbook/network')
| -rw-r--r-- | documentation/content/en/books/handbook/network/_index.adoc | 38 | ||||
| -rw-r--r-- | documentation/content/en/books/handbook/network/_index.po | 306 |
2 files changed, 204 insertions, 140 deletions
diff --git a/documentation/content/en/books/handbook/network/_index.adoc b/documentation/content/en/books/handbook/network/_index.adoc index 5d54ddd5e8..bb49981b31 100644 --- a/documentation/content/en/books/handbook/network/_index.adoc +++ b/documentation/content/en/books/handbook/network/_index.adoc @@ -577,11 +577,15 @@ The following sections discuss each step. Connecting FreeBSD to an existing wireless network is a very common situation. -This procedure shows the steps required: +This Quick Start procedure shows the steps required to connect to a network using basic authentication. +A more detailed procedure is given in the next section. -* The first step will be to obtain the SSID (Service Set Identifier) and PSK (Pre-Shared Key) for the wireless network from the network administrator. +The first step is to obtain the Service Set Identifier (SSID) and Pre-Shared Key (PSK) for the wireless network from the network administrator. -* The second step will be to add default configuration paramaters and an entry for this network to [.filename]#/etc/wpa_supplicant.conf#. If the file does not exist, create it: +The second step is to add an entry for this network to [.filename]#/etc/wpa_supplicant.conf#. + +If the file does not exist, create it. +Consult man:wpa_supplicant.conf[5] for details on formatting entries in this file. [.programlisting] .... @@ -596,10 +600,28 @@ network={ } .... -<.> Is the SSID of the wireless network. Replace it with the name of the wireless network. -<.> Is the PSK of the wireless network. Replace it with the password of the wireless network. +<.> Is the SSID of the wireless network. +Replace it with the name of the wireless network. +<.> Is the PSK of the wireless network. +Replace it with the password of the wireless network. + +The third step is to add the network interface entry to configure the network on startup. +Obtain the network device interface by using the sysctl `net.wlan.devices`. +In the listing below, the output of this sysctl shows the network device interface is "iwn0". + +[source,shell] +.... +# sysctl net.wlan.devices +.... + +The output should be similar to the following: + +[.programlisting] +.... +net.wlan.devices: iwm0 +.... -* The third step will be to add the network entry to configure the network on startup: +In the sysrc line that follows, replace "iwn0" with the output of the sysctl command if needed. [source,shell] .... @@ -607,7 +629,7 @@ network={ # sysrc ifconfig_wlan0="WPA DHCP" .... -* And the last step will be the restart `netif` service executing the following command: +* And the last step is to restart the `netif` service executing the following command: [source,shell] .... @@ -617,7 +639,7 @@ network={ [[basic-wireless-configuration]] === Basic Wireless Configuration -The first step will be to configure the wireless network card to an interface. +This section provides a more detailed example of configuring a wireless network card. To find out what wireless network cards are in the system check the section crossref:network[config-identify-network-adapter, Identify Network Adapters]. diff --git a/documentation/content/en/books/handbook/network/_index.po b/documentation/content/en/books/handbook/network/_index.po index 71bbbb22ab..a7f30cd705 100644 --- a/documentation/content/en/books/handbook/network/_index.po +++ b/documentation/content/en/books/handbook/network/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-06-29 21:20+0100\n" +"POT-Creation-Date: 2025-08-17 20:54+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -186,8 +186,9 @@ msgstr "" #: documentation/content/en/books/handbook/network/_index.adoc:299 #: documentation/content/en/books/handbook/network/_index.adoc:338 #: documentation/content/en/books/handbook/network/_index.adoc:403 -#: documentation/content/en/books/handbook/network/_index.adoc:664 -#: documentation/content/en/books/handbook/network/_index.adoc:791 +#: documentation/content/en/books/handbook/network/_index.adoc:618 +#: documentation/content/en/books/handbook/network/_index.adoc:691 +#: documentation/content/en/books/handbook/network/_index.adoc:818 msgid "The output should be similar to the following:" msgstr "" @@ -455,7 +456,7 @@ msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/network/_index.adoc:229 -#: documentation/content/en/books/handbook/network/_index.adoc:625 +#: documentation/content/en/books/handbook/network/_index.adoc:652 msgid "" "To make the change persist across reboots execute the following command:" msgstr "" @@ -614,8 +615,8 @@ msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/network/_index.adoc:328 -#: documentation/content/en/books/handbook/network/_index.adoc:610 -#: documentation/content/en/books/handbook/network/_index.adoc:731 +#: documentation/content/en/books/handbook/network/_index.adoc:637 +#: documentation/content/en/books/handbook/network/_index.adoc:758 #, no-wrap msgid "# service netif restart\n" msgstr "" @@ -1247,26 +1248,46 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:581 -msgid "This procedure shows the steps required:" +#: documentation/content/en/books/handbook/network/_index.adoc:582 +msgid "" +"This Quick Start procedure shows the steps required to connect to a network " +"using basic authentication. A more detailed procedure is given in the next " +"section." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/network/_index.adoc:584 +msgid "" +"The first step is to obtain the Service Set Identifier (SSID) and Pre-Shared " +"Key (PSK) for the wireless network from the network administrator." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:583 +#: documentation/content/en/books/handbook/network/_index.adoc:586 msgid "" -"The first step will be to obtain the SSID (Service Set Identifier) and PSK " -"(Pre-Shared Key) for the wireless network from the network administrator." +"The second step is to add an entry for this network to [.filename]#/etc/" +"wpa_supplicant.conf#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:585 +#: documentation/content/en/books/handbook/network/_index.adoc:589 msgid "" -"The second step will be to add an entry for this network to [.filename]#/etc/" -"wpa_supplicant.conf#. If the file does not exist, create it:" +"If the file does not exist, create it. Consult man:wpa_supplicant.conf[5] " +"for details on formatting entries in this file." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:592 +#: documentation/content/en/books/handbook/network/_index.adoc:596 +#, no-wrap +msgid "" +"ctrl_interface=/var/run/wpa_supplicant\n" +"eapol_version=1\n" +"ap_scan=1\n" +"fast_reauth=1\n" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/network/_index.adoc:601 #, no-wrap msgid "" "network={\n" @@ -1276,28 +1297,49 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:595 +#: documentation/content/en/books/handbook/network/_index.adoc:605 msgid "" -"Is the SSID of the wireless network. Replace it with the name of the " +"Is the SSID of the wireless network. Replace it with the name of the " "wireless network." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:596 +#: documentation/content/en/books/handbook/network/_index.adoc:607 msgid "" -"Is the PSK of the wireless network. Replace it with the password of the " +"Is the PSK of the wireless network. Replace it with the password of the " "wireless network." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:598 +#: documentation/content/en/books/handbook/network/_index.adoc:611 msgid "" -"The third step will be to add the network entry to configure the network on " -"startup:" +"The third step is to add the network interface entry to configure the " +"network on startup. Obtain the network device interface by using the sysctl " +"`net.wlan.devices`. In the listing below, the output of this sysctl shows " +"the network device interface is \"iwn0\"." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:603 +#: documentation/content/en/books/handbook/network/_index.adoc:615 +#, no-wrap +msgid "# sysctl net.wlan.devices\n" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/network/_index.adoc:622 +#, no-wrap +msgid "net.wlan.devices: iwm0\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/network/_index.adoc:625 +msgid "" +"In the sysrc line that follows, replace \"iwn0\" with the output of the " +"sysctl command if needed." +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/network/_index.adoc:630 #, no-wrap msgid "" "# sysrc wlans_iwn0=\"wlan0\"\n" @@ -1305,41 +1347,41 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:606 +#: documentation/content/en/books/handbook/network/_index.adoc:633 msgid "" -"And the last step will be the restart `netif` service executing the " -"following command:" +"And the last step is to restart the `netif` service executing the following " +"command:" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:613 +#: documentation/content/en/books/handbook/network/_index.adoc:640 #, no-wrap msgid "Basic Wireless Configuration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:618 +#: documentation/content/en/books/handbook/network/_index.adoc:645 msgid "" -"The first step will be to configure the wireless network card to an " -"interface. To find out what wireless network cards are in the system check " -"the section crossref:network[config-identify-network-adapter, Identify " +"This section provides a more detailed example of configuring a wireless " +"network card. To find out what wireless network cards are in the system " +"check the section crossref:network[config-identify-network-adapter, Identify " "Network Adapters]." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:622 +#: documentation/content/en/books/handbook/network/_index.adoc:649 #, no-wrap msgid "# ifconfig wlan0 create wlandev iwm0\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:629 +#: documentation/content/en/books/handbook/network/_index.adoc:656 #, no-wrap msgid "# sysrc wlans_iwm0=\"wlan0\"\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:634 +#: documentation/content/en/books/handbook/network/_index.adoc:661 msgid "" "Since the regulatory situation is different in various parts of the world, " "it is necessary to correctly set the domains that apply to your location to " @@ -1347,53 +1389,53 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:637 +#: documentation/content/en/books/handbook/network/_index.adoc:664 msgid "" "The available region definitions can be found in [.filename]#/etc/" "regdomain.xml#. To set the data at runtime, use `ifconfig`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:641 +#: documentation/content/en/books/handbook/network/_index.adoc:668 #, no-wrap msgid "# ifconfig wlan0 regdomain etsi2 country AT\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:644 +#: documentation/content/en/books/handbook/network/_index.adoc:671 msgid "To persist the settings, add it to [.filename]#/etc/rc.conf#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:648 +#: documentation/content/en/books/handbook/network/_index.adoc:675 #, no-wrap msgid "# sysrc create_args_wlan0=\"country AT regdomain etsi2\"\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:652 +#: documentation/content/en/books/handbook/network/_index.adoc:679 #, no-wrap msgid "Scan Wireless Networks" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:655 +#: documentation/content/en/books/handbook/network/_index.adoc:682 msgid "Available wireless networks can be scanned using man:ifconfig[8]." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:657 +#: documentation/content/en/books/handbook/network/_index.adoc:684 msgid "To list the wireless networks execute the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:661 +#: documentation/content/en/books/handbook/network/_index.adoc:688 #, no-wrap msgid "# ifconfig wlan0 up list scan\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:674 +#: documentation/content/en/books/handbook/network/_index.adoc:701 #, no-wrap msgid "" "SSID/MESH ID BSSID CHAN RATE S:N INT CAPS\n" @@ -1406,17 +1448,17 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:677 +#: documentation/content/en/books/handbook/network/_index.adoc:704 msgid "SSID/MESH ID identifies the name of the network." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:678 +#: documentation/content/en/books/handbook/network/_index.adoc:705 msgid "BSSID identifies the MAC address of the access point." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:679 +#: documentation/content/en/books/handbook/network/_index.adoc:706 msgid "" "CAPS field identifies the type of each network and the capabilities of the " "stations operating there (see the definition of `list scan` in " @@ -1424,13 +1466,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:681 +#: documentation/content/en/books/handbook/network/_index.adoc:708 #, no-wrap msgid "Connection and Authentication to a Wireless Network" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:686 +#: documentation/content/en/books/handbook/network/_index.adoc:713 msgid "" "Once a wireless network has been selected from the list of scanned networks, " "it is necessary to perform the connection and the authentication. In the " @@ -1442,20 +1484,20 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/network/_index.adoc:688 +#: documentation/content/en/books/handbook/network/_index.adoc:715 #, no-wrap msgid "Authenticate with WPA2/WPA/Personal" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:691 +#: documentation/content/en/books/handbook/network/_index.adoc:718 msgid "" "The authentication process in a wireless network is managed by " "man:wpa_supplicant[8]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:694 +#: documentation/content/en/books/handbook/network/_index.adoc:721 msgid "" "The man:wpa_supplicant[8] configuration will be made in the [.filename]#/etc/" "wpa_supplicant.conf# file. For more information, see " @@ -1463,7 +1505,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:696 +#: documentation/content/en/books/handbook/network/_index.adoc:723 msgid "" "Once the scanning of the wireless networks has been carried out, a network " "has been chosen and have the password (PSK), that information will be added " @@ -1472,7 +1514,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:704 +#: documentation/content/en/books/handbook/network/_index.adoc:731 #, no-wrap msgid "" "network={\n" @@ -1483,61 +1525,61 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:707 +#: documentation/content/en/books/handbook/network/_index.adoc:734 msgid "" "SSID scan technique. Only need to use this option if the network is hidden." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:708 +#: documentation/content/en/books/handbook/network/_index.adoc:735 msgid "Network name." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:709 +#: documentation/content/en/books/handbook/network/_index.adoc:736 msgid "Password of the wireless network." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:711 +#: documentation/content/en/books/handbook/network/_index.adoc:738 msgid "" "The next step will be to configure the wireless connection in the file " "[.filename]#/etc/rc.conf#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:713 +#: documentation/content/en/books/handbook/network/_index.adoc:740 msgid "" "To use a static address it will be necessary to execute the following " "command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:717 +#: documentation/content/en/books/handbook/network/_index.adoc:744 #, no-wrap msgid "# sysrc ifconfig_wlan0=\"inet 192.168.1.20 netmask 255.255.255.0\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:720 +#: documentation/content/en/books/handbook/network/_index.adoc:747 msgid "" "To use a dynamic address it will be necessary to execute the following " "command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:724 +#: documentation/content/en/books/handbook/network/_index.adoc:751 #, no-wrap msgid "# sysrc ifconfig_wlan0=\"WPA DHCP\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:727 +#: documentation/content/en/books/handbook/network/_index.adoc:754 msgid "Then restart the network executing the following command:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:736 +#: documentation/content/en/books/handbook/network/_index.adoc:763 msgid "" "More information on how to perform more advanced methods of authentication " "can be obtained at crossref:advanced-networking[network-advanced-wireless," @@ -1545,50 +1587,50 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/network/_index.adoc:739 +#: documentation/content/en/books/handbook/network/_index.adoc:766 #, no-wrap msgid "Authenticate with Open Networks" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:744 +#: documentation/content/en/books/handbook/network/_index.adoc:771 msgid "" "It is important that the user is *very* careful when connecting to open " "networks without any kind of authentication." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:747 +#: documentation/content/en/books/handbook/network/_index.adoc:774 msgid "" "Once the wireless network scan is done and the SSID of the wireless network " "is selected, execute the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:751 +#: documentation/content/en/books/handbook/network/_index.adoc:778 #, no-wrap msgid "# ifconfig wlan0 ssid SSID\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:754 +#: documentation/content/en/books/handbook/network/_index.adoc:781 msgid "And then execute man:dhclient[8] to get the address configured:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:758 +#: documentation/content/en/books/handbook/network/_index.adoc:785 #, no-wrap msgid "# dhclient wlan0\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:760 +#: documentation/content/en/books/handbook/network/_index.adoc:787 #, no-wrap msgid "Using Both Wired and Wireless Connections" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:764 +#: documentation/content/en/books/handbook/network/_index.adoc:791 msgid "" "A wired connection provides better performance and reliability, while a " "wireless connection provides flexibility and mobility. Laptop users " @@ -1596,7 +1638,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:767 +#: documentation/content/en/books/handbook/network/_index.adoc:794 msgid "" "On FreeBSD, it is possible to combine two or even more network interfaces " "together in a \"failover\" fashion. This type of configuration uses the " @@ -1605,7 +1647,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:769 +#: documentation/content/en/books/handbook/network/_index.adoc:796 msgid "" "Link aggregation and failover is covered in crossref:advanced-" "networking[network-aggregation,\"Link Aggregation and Failover\"] and an " @@ -1615,74 +1657,74 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/network/_index.adoc:771 +#: documentation/content/en/books/handbook/network/_index.adoc:798 #, no-wrap msgid "Hostname" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:774 +#: documentation/content/en/books/handbook/network/_index.adoc:801 msgid "" "The hostname represents the fully qualified domain name (FQDN) of the host " "on the network." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:778 +#: documentation/content/en/books/handbook/network/_index.adoc:805 msgid "" "If no hostname is set for the host, FreeBSD will call itself `Amnesiac`." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:781 +#: documentation/content/en/books/handbook/network/_index.adoc:808 #, no-wrap msgid "Check The Current Hostname" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:784 +#: documentation/content/en/books/handbook/network/_index.adoc:811 msgid "man:hostname[1] can be used to check the current hostname:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:788 +#: documentation/content/en/books/handbook/network/_index.adoc:815 #, no-wrap msgid "$ hostname\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:795 +#: documentation/content/en/books/handbook/network/_index.adoc:822 #, no-wrap msgid "freebsdhostname.example.com\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:798 +#: documentation/content/en/books/handbook/network/_index.adoc:825 #, no-wrap msgid "Change Hostname" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:801 +#: documentation/content/en/books/handbook/network/_index.adoc:828 msgid "" "To change the hostname of the host and persist it across reboots execute the " "following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:805 +#: documentation/content/en/books/handbook/network/_index.adoc:832 #, no-wrap msgid "# sysrc hostname=\"freebsdhostname.example.com\"\n" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/network/_index.adoc:808 +#: documentation/content/en/books/handbook/network/_index.adoc:835 #, no-wrap msgid "DNS" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:811 +#: documentation/content/en/books/handbook/network/_index.adoc:838 msgid "" "The DNS could be understood as a link:https://en.wikipedia.org/wiki/" "Telephone_directory[telephone directory] in which an IP is identified to a " @@ -1690,7 +1732,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:814 +#: documentation/content/en/books/handbook/network/_index.adoc:841 msgid "" "There are three files that handle how a FreeBSD system interact with the " "DNS. These three files are man:hosts[5], man:resolv.conf[5] and " @@ -1698,7 +1740,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:816 +#: documentation/content/en/books/handbook/network/_index.adoc:843 msgid "" "Unless otherwise stated in the [.filename]#/etc/nsswitch.conf# file, FreeBSD " "will look at the addresses in the [.filename]#/etc/hosts# file and then the " @@ -1706,46 +1748,46 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:820 +#: documentation/content/en/books/handbook/network/_index.adoc:847 msgid "" "The man:nsswitch.conf[5] file specifies how the nsdispatch (name-service " "switch dispatcher) should operate." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:822 +#: documentation/content/en/books/handbook/network/_index.adoc:849 msgid "" "By default, the hosts section of the [.filename]#/etc/nsswitch.conf# file " "will be as follows:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:826 +#: documentation/content/en/books/handbook/network/_index.adoc:853 #, no-wrap msgid "hosts: files dns\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:830 +#: documentation/content/en/books/handbook/network/_index.adoc:857 msgid "" "For example, in case of using the man:nscd[8] service. The order of " "preference could be changed by leaving the line as follows:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:834 +#: documentation/content/en/books/handbook/network/_index.adoc:861 #, no-wrap msgid "hosts: files cache dns\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:838 +#: documentation/content/en/books/handbook/network/_index.adoc:865 #, no-wrap msgid "Local addresses" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:843 +#: documentation/content/en/books/handbook/network/_index.adoc:870 msgid "" "The [.filename]#/etc/hosts# file is a simple text database who provide host " "name to IP address mappings. Entries for local computers connected via a " @@ -1756,7 +1798,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:845 +#: documentation/content/en/books/handbook/network/_index.adoc:872 msgid "" "For example, in the case of having a local instance of package:www/gitlab-" "ce[] in a local environment, it could be added as follows to the file " @@ -1764,72 +1806,72 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:849 +#: documentation/content/en/books/handbook/network/_index.adoc:876 #, no-wrap msgid "192.168.1.150 git.example.com git\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:852 +#: documentation/content/en/books/handbook/network/_index.adoc:879 #, no-wrap msgid "Configuring the Nameserver" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:855 +#: documentation/content/en/books/handbook/network/_index.adoc:882 msgid "" "How a FreeBSD system accesses the Internet Domain Name System (DNS) is " "controlled by man:resolv.conf[5]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:857 +#: documentation/content/en/books/handbook/network/_index.adoc:884 msgid "The most common entries to [.filename]#/etc/resolv.conf# are:" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/network/_index.adoc:863 +#: documentation/content/en/books/handbook/network/_index.adoc:890 #, no-wrap msgid "`nameserver`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/network/_index.adoc:865 +#: documentation/content/en/books/handbook/network/_index.adoc:892 #, no-wrap msgid "The IP address of a name server the resolver should query. The servers are queried in the order listed with a maximum of three." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/network/_index.adoc:866 +#: documentation/content/en/books/handbook/network/_index.adoc:893 #, no-wrap msgid "`search`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/network/_index.adoc:868 +#: documentation/content/en/books/handbook/network/_index.adoc:895 #, no-wrap msgid "Search list for hostname lookup. This is normally determined by the domain of the local hostname." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/network/_index.adoc:869 +#: documentation/content/en/books/handbook/network/_index.adoc:896 #, no-wrap msgid "`domain`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/network/_index.adoc:870 +#: documentation/content/en/books/handbook/network/_index.adoc:897 #, no-wrap msgid "The local domain name." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:873 +#: documentation/content/en/books/handbook/network/_index.adoc:900 msgid "A typical [.filename]#/etc/resolv.conf# looks like this:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:879 +#: documentation/content/en/books/handbook/network/_index.adoc:906 #, no-wrap msgid "" "search example.com\n" @@ -1838,87 +1880,87 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:884 +#: documentation/content/en/books/handbook/network/_index.adoc:911 msgid "Only one of the `search` and `domain` options should be used." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:887 +#: documentation/content/en/books/handbook/network/_index.adoc:914 msgid "" "When using DHCP, man:dhclient[8] usually rewrites [.filename]#/etc/" "resolv.conf# with information received from the DHCP server." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:891 +#: documentation/content/en/books/handbook/network/_index.adoc:918 msgid "" "If the machine in which the configuration is being made is *not* a DNS " "server, man:local-unbound[8] can be used to improve DNS lookup performance." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:893 +#: documentation/content/en/books/handbook/network/_index.adoc:920 msgid "To enable it at boot time execute the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:897 +#: documentation/content/en/books/handbook/network/_index.adoc:924 #, no-wrap msgid "# sysrc local_unbound_enable=\"YES\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:900 +#: documentation/content/en/books/handbook/network/_index.adoc:927 msgid "" "To start the man:local-unbound[8] service execute the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/network/_index.adoc:904 +#: documentation/content/en/books/handbook/network/_index.adoc:931 #, no-wrap msgid "# service local_unbound start\n" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/network/_index.adoc:908 +#: documentation/content/en/books/handbook/network/_index.adoc:935 #, no-wrap msgid "Troubleshooting" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:911 +#: documentation/content/en/books/handbook/network/_index.adoc:938 msgid "" "When troubleshooting hardware and software configurations, check the simple " "things first." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:913 +#: documentation/content/en/books/handbook/network/_index.adoc:940 msgid "Is the network cable plugged in?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:914 +#: documentation/content/en/books/handbook/network/_index.adoc:941 msgid "Are the network services properly configured?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:915 +#: documentation/content/en/books/handbook/network/_index.adoc:942 msgid "Is the firewall configured correctly?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:916 +#: documentation/content/en/books/handbook/network/_index.adoc:943 msgid "Is the NIC supported by FreeBSD?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:917 +#: documentation/content/en/books/handbook/network/_index.adoc:944 msgid "Is the router working correctly?" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/network/_index.adoc:921 +#: documentation/content/en/books/handbook/network/_index.adoc:948 msgid "" "Before sending a bug report, always check the Hardware Notes in the " "link:https://www.freebsd.org/releases/[FreeBSD release page], update the " @@ -1927,13 +1969,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:924 +#: documentation/content/en/books/handbook/network/_index.adoc:951 #, no-wrap msgid "Troubleshooting in Wired Networks" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:928 +#: documentation/content/en/books/handbook/network/_index.adoc:955 msgid "" "If the card works, yet performance is poor, read through man:tuning[7]. " "Also, check the network configuration as incorrect network settings can " @@ -1941,7 +1983,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:933 +#: documentation/content/en/books/handbook/network/_index.adoc:960 msgid "" "`No route to host` messages occur if the system is unable to route a packet " "to the destination host. This can happen if no default route is specified " @@ -1951,7 +1993,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:937 +#: documentation/content/en/books/handbook/network/_index.adoc:964 msgid "" "`ping: sendto: Permission denied` error messages are often caused by a " "misconfigured firewall. If a firewall is enabled on FreeBSD but no rules " @@ -1961,20 +2003,20 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/network/_index.adoc:939 +#: documentation/content/en/books/handbook/network/_index.adoc:966 #, no-wrap msgid "Troubleshooting in Wireless Networks" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:942 +#: documentation/content/en/books/handbook/network/_index.adoc:969 msgid "" "This section describes a number of steps to help troubleshoot common " "wireless networking problems." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:944 +#: documentation/content/en/books/handbook/network/_index.adoc:971 msgid "" "If the access point is not listed when scanning, check that the " "configuration has not limited the wireless device to a limited set of " @@ -1982,7 +2024,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:946 +#: documentation/content/en/books/handbook/network/_index.adoc:973 msgid "" "If the device cannot associate with an access point, verify that the " "configuration matches the settings on the access point. This includes the " @@ -1993,14 +2035,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:948 +#: documentation/content/en/books/handbook/network/_index.adoc:975 msgid "" "Once the system can associate with the access point, diagnose the network " "configuration using tools like man:ping[8]." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/network/_index.adoc:949 +#: documentation/content/en/books/handbook/network/_index.adoc:976 msgid "" "There are many lower-level debugging tools. Debugging messages can be " "enabled in the 802.11 protocol support layer using man:wlandebug[8]." |