# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2025-11-08 16:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: YAML Front Matter: description #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:1 #, no-wrap msgid "FreeBSD supports the Point-to-Point (PPP) protocol which can be used to establish a network or Internet connection using a dial-up modem" msgstr "" #. type: YAML Front Matter: part #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:1 #, no-wrap msgid "IV. Network Communication" msgstr "" #. type: YAML Front Matter: title #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:1 #, no-wrap msgid "Chapter 30. PPP" msgstr "" #. type: Title = #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:15 #, no-wrap msgid "PPP" msgstr "" #. type: Title == #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:53 #, no-wrap msgid "Synopsis" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:57 msgid "" "FreeBSD supports the Point-to-Point (PPP) protocol which can be used to " "establish a network or Internet connection using a dial-up modem. This " "chapter describes how to configure modem-based communication services in " "FreeBSD." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:59 msgid "Read this chapter to learn:" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:61 msgid "How to configure, use, and troubleshoot a PPP connection." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:62 msgid "How to set up PPP over Ethernet (PPPoE)." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:63 msgid "How to set up PPP over ATM (PPPoA)." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:65 msgid "Before reading this chapter:" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:67 msgid "Be familiar with basic network terminology." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:68 msgid "Understand the basics and purpose of a dial-up connection and PPP." msgstr "" #. type: Title == #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:70 #, no-wrap msgid "Configuring PPP" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:76 msgid "" "FreeBSD provides built-in support for managing dial-up PPP connections using " "man:ppp[8]. The default FreeBSD kernel provides support for " "[.filename]#tun# which is used to interact with a modem hardware. " "Configuration is performed by editing at least one configuration file, and " "configuration files containing examples are provided. Finally, `ppp` is " "used to start and manage connections." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:78 msgid "In order to use a PPP connection, the following items are needed:" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:80 msgid "A dial-up account with an Internet Service Provider (ISP)." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:81 msgid "A dial-up modem." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:82 msgid "The dial-up number for the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:83 msgid "The login name and password assigned by the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:84 msgid "" "The IP address of one or more DNS servers. Normally, the ISP provides these " "addresses. If it did not, FreeBSD can be configured to use DNS negotiation." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:86 msgid "If any of the required information is missing, contact the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:88 msgid "" "The following information may be supplied by the ISP, but is not necessary:" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:90 msgid "" "The IP address of the default gateway. If this information is unknown, the " "ISP will automatically provide the correct value during connection setup. " "When configuring PPP on FreeBSD, this address is referred to as `HISADDR`." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:92 msgid "" "The subnet mask. If the ISP has not provided one, `255.255.255.255` will be " "used in the man:ppp[8] configuration file. *" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:94 msgid "" "If the ISP has assigned a static IP address and hostname, it should be input " "into the configuration file. Otherwise, this information will be " "automatically provided during connection setup." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:97 msgid "" "The rest of this section demonstrates how to configure FreeBSD for common " "PPP connection scenarios. The required configuration file is [.filename]#/" "etc/ppp/ppp.conf# and additional files and examples are available in " "[.filename]#/usr/share/examples/ppp/#." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:102 msgid "" "Throughout this section, many of the file examples display line numbers. " "These line numbers have been added to make it easier to follow the " "discussion and are not meant to be placed in the actual file." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:105 msgid "" "When editing a configuration file, proper indentation is important. Lines " "that end in a `:` start in the first column (beginning of the line) while " "all other lines should be indented as shown using spaces or tabs." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:108 #, no-wrap msgid "Basic Configuration" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:112 msgid "" "In order to configure a PPP connection, first edit [.filename]#/etc/ppp/" "ppp.conf# with the dial-in information for the ISP. This file is described " "as follows:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:132 #, no-wrap msgid "" "1 default:\n" "2 set log Phase Chat LCP IPCP CCP tun command\n" "3 ident user-ppp VERSION\n" "4 set device /dev/cuau0\n" "5 set speed 115200\n" "6 set dial \"ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 5 \\\n" "7 \\\"\\\" AT OK-AT-OK ATE1Q0 OK \\\\dATDT\\\\T TIMEOUT 40 CONNECT\"\n" "8 set timeout 180\n" "9 enable dns\n" "10\n" "11 provider:\n" "12 set phone \"(123) 456 7890\"\n" "13 set authname foo\n" "14 set authkey bar\n" "15 set timeout 300\n" "16 set ifaddr x.x.x.x/0 y.y.y.y/0 255.255.255.255 0.0.0.0\n" "17 add default HISADDR\n" msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:134 #, no-wrap msgid "Line 1" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:137 msgid "" "Identifies the `default` entry. Commands in this entry (lines 2 through 9) " "are executed automatically when `ppp` is run." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:138 #, no-wrap msgid "Line 2" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:141 msgid "" "Enables verbose logging parameters for testing the connection. Once the " "configuration is working satisfactorily, this line should be reduced to:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:145 #, no-wrap msgid "set log phase tun\n" msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:147 #, no-wrap msgid "Line 3" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:149 msgid "" "Displays the version of man:ppp[8] to the PPP software running on the other " "side of the connection." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:150 #, no-wrap msgid "Line 4" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:152 msgid "" "Identifies the device to which the modem is connected, where " "[.filename]#COM1# is [.filename]#/dev/cuau0# and [.filename]#COM2# is " "[.filename]#/dev/cuau1#." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:153 #, no-wrap msgid "Line 5" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:156 msgid "" "Sets the connection speed. If `115200` does not work on an older modem, try " "`38400` instead." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:157 #, no-wrap msgid "Lines 6 & 7" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:160 msgid "" "The dial string written as an expect-send syntax. Refer to man:chat[8] for " "more information." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:163 msgid "" "Note that this command continues onto the next line for readability. Any " "command in [.filename]#ppp.conf# may do this if the last character on the " "line is `\\`." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:164 #, no-wrap msgid "Line 8" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:166 msgid "Sets the idle timeout for the link in seconds." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:167 #, no-wrap msgid "Line 9" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:170 msgid "" "Instructs the peer to confirm the DNS settings. If the local network is " "running its own DNS server, this line should be commented out, by adding a " "`+#+` at the beginning of the line, or removed." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:171 #, no-wrap msgid "Line 10" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:173 msgid "A blank line for readability. Blank lines are ignored by man:ppp[8]." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:174 #, no-wrap msgid "Line 11" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:177 msgid "" "Identifies an entry called `provider`. This could be changed to the name of " "the ISP so that `load _ISP_` can be used to start the connection." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:178 #, no-wrap msgid "Line 12" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:184 msgid "" "Use the phone number for the ISP. Multiple phone numbers may be specified " "using the colon (`:`) or pipe character (`|`) as a separator. To rotate " "through the numbers, use a colon. To always attempt to dial the first " "number first and only use the other numbers if the first number fails, use " "the pipe character. Always enclose the entire set of phone numbers between " "quotation marks (`\"`) to prevent dialing failures." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:185 #, no-wrap msgid "Lines 13 & 14" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:187 msgid "Use the user name and password for the ISP." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:188 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:308 #, no-wrap msgid "Line 15" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:192 msgid "" "Sets the default idle timeout in seconds for the connection. In this " "example, the connection will be closed automatically after 300 seconds of " "inactivity. To prevent a timeout, set this value to zero." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:193 #, no-wrap msgid "Line 16" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:196 msgid "" "Sets the interface addresses. The values used depend upon whether a static " "IP address has been obtained from the ISP or if it instead negotiates a " "dynamic IP address during connection." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:199 msgid "" "If the ISP has allocated a static IP address and default gateway, replace " "_x.x.x.x_ with the static IP address and replace _y.y.y.y_ with the IP " "address of the default gateway. If the ISP has only provided a static IP " "address without a gateway address, replace _y.y.y.y_ with `10.0.0.2/0`." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:202 msgid "" "If the IP address changes whenever a connection is made, change this line to " "the following value. This tells man:ppp[8] to use the IP Configuration " "Protocol (IPCP) to negotiate a dynamic IP address:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:206 #, no-wrap msgid "set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.255 0.0.0.0\n" msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:208 #, no-wrap msgid "Line 17" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:212 msgid "" "Keep this line as-is as it adds a default route to the gateway. The " "`HISADDR` will automatically be replaced with the gateway address specified " "on line 16. It is important that this line appears after line 16." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:218 msgid "" "Depending upon whether man:ppp[8] is started manually or automatically, a " "[.filename]#/etc/ppp/ppp.linkup# may also need to be created which contains " "the following lines. This file is required when running `ppp` in `-auto` " "mode. This file is used after the connection has been established. At this " "point, the IP address will have been assigned and it is now possible to add " "the routing table entries. When creating this file, make sure that " "_provider_ matches the value demonstrated in line 11 of " "[.filename]#ppp.conf#." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:223 #, no-wrap msgid "" "provider:\n" " add default HISADDR\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:228 msgid "" "This file is also needed when the default gateway address is \"guessed\" in " "a static IP address configuration. In this case, remove line 17 from " "[.filename]#ppp.conf# and create [.filename]#/etc/ppp/ppp.linkup# with the " "above two lines. More examples for this file can be found in [.filename]#/" "usr/share/examples/ppp/#." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:231 msgid "" "By default, `ppp` must be run as `root`. To change this default, add the " "account of the user who should run `ppp` to the `network` group in " "[.filename]#/etc/group#." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:234 msgid "" "Then, give the user access to one or more entries in [.filename]#/etc/ppp/" "ppp.conf# with `allow`. For example, to give `fred` and `mary` permission " "to only the `provider:` entry, add this line to the `provider:` section:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:238 #, no-wrap msgid "allow users fred mary\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:241 msgid "" "To give the specified users access to all entries, put that line in the " "`default` section instead." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:242 #, no-wrap msgid "Advanced Configuration" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:245 msgid "" "It is possible to configure PPP to supply DNS and NetBIOS nameserver " "addresses on demand." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:247 msgid "" "To enable these extensions with PPP version 1.x, the following lines might " "be added to the relevant section of [.filename]#/etc/ppp/ppp.conf#." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:253 #, no-wrap msgid "" "enable msext\n" "set ns 203.14.100.1 203.14.100.2\n" "set nbns 203.14.100.5\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:256 msgid "And for PPP version 2 and above:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:262 #, no-wrap msgid "" "accept dns\n" "set dns 203.14.100.1 203.14.100.2\n" "set nbns 203.14.100.5\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:265 msgid "" "This will tell the clients the primary and secondary name server addresses, " "and a NetBIOS nameserver host." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:267 msgid "" "In version 2 and above, if the `set dns` line is omitted, PPP will use the " "values found in [.filename]#/etc/resolv.conf#." msgstr "" #. type: Title ==== #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:269 #, no-wrap msgid "PAP and CHAP Authentication" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:273 msgid "" "Some ISPs set their system up so that the authentication part of the " "connection is done using either of the PAP or CHAP authentication " "mechanisms. If this is the case, the ISP will not give a `login:` prompt at " "connection, but will start talking PPP immediately." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:276 msgid "" "PAP is less secure than CHAP, but security is not normally an issue here as " "passwords, although being sent as plain text with PAP, are being transmitted " "down a serial line only. There is not much room for crackers to " "\"eavesdrop\"." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:278 msgid "The following alterations must be made:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:284 #, no-wrap msgid "" "13 set authname MyUserName\n" "14 set authkey MyPassword\n" "15 set login\n" msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:286 #, no-wrap msgid "Line 13" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:288 msgid "" "This line specifies the PAP/CHAP user name.Insert the correct value for " "_MyUserName_." msgstr "" #. type: Labeled list #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:289 #, no-wrap msgid "Line 14" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:293 msgid "" "This line specifies the PAP/CHAP password. Insert the correct value for " "_MyPassword_. An additional line may be added, such as:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:297 #, no-wrap msgid "16 accept PAP\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:300 msgid "or" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:304 #, no-wrap msgid "16 accept CHAP\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:307 msgid "" "to make it obvious that this is the intention, but PAP and CHAP are both " "accepted by default." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:311 msgid "" "The ISP will not normally require a login to the server when using PAP or " "CHAP. Therefore, disable the \"set login\" string." msgstr "" #. type: Title ==== #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:313 #, no-wrap msgid "Using PPP Network Address Translation Capability" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:317 msgid "" "PPP has ability to use internal NAT without kernel diverting capabilities. " "This functionality may be enabled by the following line in [.filename]#/etc/" "ppp/ppp.conf#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:321 #, no-wrap msgid "nat enable yes\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:325 msgid "" "Alternatively, NAT may be enabled by command-line option `-nat`. There is " "also [.filename]#/etc/rc.conf# knob named `ppp_nat`, which is enabled by " "default." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:327 msgid "" "When using this feature, it may be useful to include the following " "[.filename]#/etc/ppp/ppp.conf# options to enable incoming connections " "forwarding:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:332 #, no-wrap msgid "" "nat port tcp 10.0.0.2:ftp ftp\n" "nat port tcp 10.0.0.2:http http\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:335 msgid "or do not trust the outside at all" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:339 #, no-wrap msgid "nat deny_incoming yes\n" msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:342 #, no-wrap msgid "Final System Configuration" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:345 msgid "" "While `ppp` is now configured, some edits still need to be made to " "[.filename]#/etc/rc.conf#." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:347 msgid "" "Working from the top down in this file, make sure the `hostname=` line is " "set:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:351 #, no-wrap msgid "hostname=\"foo.example.com\"\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:354 msgid "" "If the ISP has supplied a static IP address and name, use this name as the " "host name." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:357 msgid "" "Look for the `network_interfaces` variable. To configure the system to dial " "the ISP on demand, make sure the [.filename]#tun0# device is added to the " "list, otherwise remove it." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:362 #, no-wrap msgid "" "network_interfaces=\"lo0 tun0\"\n" "ifconfig_tun0=\n" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:368 msgid "" "The `ifconfig_tun0` variable should be empty, and a file called [.filename]#/" "etc/start_if.tun0# should be created. This file should contain the line:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:372 #, no-wrap msgid "ppp -auto mysystem\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:376 msgid "" "This script is executed at network configuration time, starting the ppp " "daemon in automatic mode. If this machine acts as a gateway, consider " "including `-alias`. Refer to the manual page for further details." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:379 msgid "" "Make sure that the router program is set to `NO` with the following line in " "[.filename]#/etc/rc.conf#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:383 #, no-wrap msgid "router_enable=\"NO\"\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:386 msgid "" "It is important that the `routed` daemon is not started, as `routed` tends " "to delete the default routing table entries created by `ppp`." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:389 msgid "" "It is probably a good idea to ensure that the `sendmail_flags` line does not " "include the `-q` option, otherwise `sendmail` will attempt to do a network " "lookup every now and then, possibly causing the machine to dial out. Try " "this:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:393 #, no-wrap msgid "sendmail_flags=\"-bd\"\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:397 msgid "" "The downside is that `sendmail` is forced to re-examine the mail queue " "whenever the ppp link. To automate this, include `!bg` in " "[.filename]#ppp.linkup#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:404 #, no-wrap msgid "" "1 provider:\n" "2 delete ALL\n" "3 add 0 0 HISADDR\n" "4 !bg sendmail -bd -q30m\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:408 msgid "" "An alternative is to set up a \"dfilter\" to block SMTP traffic. Refer to " "the sample files for further details." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:409 #, no-wrap msgid "Using `ppp`" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:413 msgid "" "All that is left is to reboot the machine. After rebooting, either type:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:417 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:536 #, no-wrap msgid "# ppp\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:420 msgid "" "and then `dial provider` to start the PPP session, or, to configure `ppp` to " "establish sessions automatically when there is outbound traffic and " "[.filename]#start_if.tun0# does not exist, type:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:424 #, no-wrap msgid "# ppp -auto provider\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:428 msgid "" "It is possible to talk to the `ppp` program while it is running in the " "background, but only if a suitable diagnostic port has been set up. To do " "this, add the following line to the configuration:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:432 #, no-wrap msgid "set server /var/run/ppp-tun%d DiagnosticPassword 0177\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:436 msgid "" "This will tell PPP to listen to the specified UNIX(R) domain socket, asking " "clients for the specified password before allowing access. The `%d` in the " "name is replaced with the [.filename]#tun# device number that is in use." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:438 msgid "" "Once a socket has been set up, the man:pppctl[8] program may be used in " "scripts that wish to manipulate the running program." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:440 #, no-wrap msgid "Configuring Dial-in Services" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:443 msgid "" "crossref:serialcomms[dialup,“Dial-in Service”] provides a good description " "on enabling dial-up services using man:getty[8]." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:445 msgid "" "An alternative to `getty` is package:comms/mgetty+sendfax[] port), a smarter " "version of `getty` designed with dial-up lines in mind." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:447 msgid "" "The advantages of using `mgetty` is that it actively _talks_ to modems, " "meaning if port is turned off in [.filename]#/etc/ttys# then the modem will " "not answer the phone." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:449 msgid "" "Later versions of `mgetty` (from 0.99beta onwards) also support the " "automatic detection of PPP streams, allowing clients scriptless access to " "the server." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:451 msgid "" "Refer to http://mgetty.greenie.net/doc/mgetty_toc.html[http://" "mgetty.greenie.net/doc/mgetty_toc.html] for more information on `mgetty`." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:454 msgid "" "By default the package:comms/mgetty+sendfax[] port comes with the `AUTO_PPP` " "option enabled allowing `mgetty` to detect the LCP phase of PPP connections " "and automatically spawn off a ppp shell. However, since the default login/" "password sequence does not occur it is necessary to authenticate users using " "either PAP or CHAP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:456 msgid "" "This section assumes the user has successfully compiled, and installed the " "package:comms/mgetty+sendfax[] port on his system." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:458 msgid "" "Ensure that [.filename]#/usr/local/etc/mgetty+sendfax/login.config# has the " "following:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:462 #, no-wrap msgid "/AutoPPP/ - - /etc/ppp/ppp-pap-dialup\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:465 msgid "" "This tells `mgetty` to run [.filename]#ppp-pap-dialup# for detected PPP " "connections." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:467 msgid "" "Create an executable file called [.filename]#/etc/ppp/ppp-pap-dialup# " "containing the following:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:472 #, no-wrap msgid "" "#!/bin/sh\n" "exec /usr/sbin/ppp -direct pap$IDENT\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:476 msgid "" "For each dial-up line enabled in [.filename]#/etc/ttys#, create a " "corresponding entry in [.filename]#/etc/ppp/ppp.conf#. This will happily co-" "exist with the definitions we created above." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:483 #, no-wrap msgid "" "pap:\n" " enable pap\n" " set ifaddr 203.14.100.1 203.14.100.20-203.14.100.40\n" " enable proxy\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:486 msgid "" "Each user logging in with this method will need to have a username/password " "in [.filename]#/etc/ppp/ppp.secret#, or alternatively add the following " "option to authenticate users via PAP from [.filename]#/etc/passwd#." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:490 #, no-wrap msgid "enable passwdauth\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:494 msgid "" "To assign some users a static IP number, specify the number as the third " "argument in [.filename]#/etc/ppp/ppp.secret#. See [.filename]#/usr/share/" "examples/ppp/ppp.secret.sample# for examples." msgstr "" #. type: Title == #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:496 #, no-wrap msgid "Troubleshooting PPP Connections" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:502 msgid "" "This section covers a few issues which may arise when using PPP over a modem " "connection. Some ISPs present the `ssword` prompt while others present " "`password`. If the `ppp` script is not written accordingly, the login " "attempt will fail. The most common way to debug `ppp` connections is by " "connecting manually as described in this section." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:503 #, no-wrap msgid "Check the Device Nodes" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:506 msgid "" "When using a custom kernel, make sure to include the following line in the " "kernel configuration file:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:510 #, no-wrap msgid "device uart\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:514 msgid "" "The [.filename]#uart# device is already included in the `GENERIC` kernel, so " "no additional steps are necessary in this case. Just check the `dmesg` " "output for the modem device with:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:518 #, no-wrap msgid "# dmesg | grep uart\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:525 msgid "" "This should display some pertinent output about the [.filename]#uart# " "devices. These are the COM ports we need. If the modem acts like a " "standard serial port, it should be listed on [.filename]#uart1#, or " "[.filename]#COM2#. If so, a kernel rebuild is not required. When matching " "up, if the modem is on [.filename]#uart1#, the modem device would be " "[.filename]#/dev/cuau1#." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:526 #, no-wrap msgid "Connecting Manually" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:532 msgid "" "Connecting to the Internet by manually controlling `ppp` is quick, easy, and " "a great way to debug a connection or just get information on how the ISP " "treats `ppp` client connections. Lets start PPP from the command line. " "Note that in all of our examples we will use _example_ as the hostname of " "the machine running PPP. To start `ppp`:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:541 #, no-wrap msgid "ppp ON example> set device /dev/cuau1\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:544 msgid "This second command sets the modem device to [.filename]#cuau1#." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:548 #, no-wrap msgid "ppp ON example> set speed 115200\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:551 msgid "This sets the connection speed to 115,200 kbps." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:555 #, no-wrap msgid "ppp ON example> enable dns\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:559 msgid "" "This tells `ppp` to configure the resolver and add the nameserver lines to " "[.filename]#/etc/resolv.conf#. If `ppp` cannot determine the hostname, it " "can manually be set later." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:563 #, no-wrap msgid "ppp ON example> term\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:566 msgid "" "This switches to \"terminal\" mode in order to manually control the modem." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:571 #, no-wrap msgid "" "deflink: Entering terminal mode on /dev/cuau1\n" "type '~h' for help\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:578 #, no-wrap msgid "" "at\n" "OK\n" "atdt123456789\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:581 msgid "" "Use `at` to initialize the modem, then use `atdt` and the number for the ISP " "to begin the dial in process." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:585 #, no-wrap msgid "CONNECT\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:588 msgid "" "Confirmation of the connection, if we are going to have any connection " "problems, unrelated to hardware, here is where we will attempt to resolve " "them." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:592 #, no-wrap msgid "ISP Login:myusername\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:595 msgid "" "At this prompt, return the prompt with the username that was provided by the " "ISP." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:599 #, no-wrap msgid "ISP Pass:mypassword\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:603 msgid "" "At this prompt, reply with the password that was provided by the ISP. Just " "like logging into FreeBSD, the password will not echo." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:607 #, no-wrap msgid "Shell or PPP:ppp\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:612 msgid "" "Depending on the ISP, this prompt might not appear. If it does, it is " "asking whether to use a shell on the provider or to start `ppp`. In this " "example, `ppp` was selected in order to establish an Internet connection." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:616 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:624 #, no-wrap msgid "Ppp ON example>\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:620 msgid "" "Notice that in this example the first `p` has been capitalized. This shows " "that we have successfully connected to the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:627 msgid "" "We have successfully authenticated with our ISP and are waiting for the " "assigned IP address." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:631 #, no-wrap msgid "PPP ON example>\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:634 msgid "" "We have made an agreement on an IP address and successfully completed our " "connection." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:638 #, no-wrap msgid "PPP ON example>add default HISADDR\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:643 msgid "" "Here we add our default route, we need to do this before we can talk to the " "outside world as currently the only established connection is with the " "peer. If this fails due to existing routes, put a bang character `!` in " "front of the `add`. Alternatively, set this before making the actual " "connection and it will negotiate a new route accordingly." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:648 msgid "" "If everything went good we should now have an active connection to the " "Internet, which could be thrown into the background using kbd:[CTRL+z]. If " "`PPP` returns to `ppp` the connection has been lost. This is good to know " "because it shows the connection status. Capital P's represent a connection " "to the ISP and lowercase p's show that the connection has been lost." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:649 #, no-wrap msgid "Debugging" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:655 msgid "" "If a connection cannot be established, turn hardware flow CTS/RTS to off " "using `set ctsrts off`. This is mainly the case when connected to some PPP-" "capable terminal servers, where PPP hangs when it tries to write data to the " "communication link, and waits for a Clear To Send (CTS) signal which may " "never come. When using this option, include `set accmap` as it may be " "required to defeat hardware dependent on passing certain characters from end " "to end, most of the time XON/XOFF. Refer to man:ppp[8] for more information " "on this option and how it is used." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:658 msgid "" "An older modem may need `set parity even`. Parity is set at none be " "default, but is used for error checking with a large increase in traffic, on " "older modems." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:661 msgid "" "PPP may not return to the command mode, which is usually a negotiation error " "where the ISP is waiting for negotiating to begin. At this point, using " "`~p` will force ppp to start sending the configuration information." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:664 msgid "" "If a login prompt never appears, PAP or CHAP authentication is most likely " "required. To use PAP or CHAP, add the following options to PPP before going " "into terminal mode:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:668 #, no-wrap msgid "ppp ON example> set authname myusername\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:671 msgid "" "Where _myusername_ should be replaced with the username that was assigned by " "the ISP." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:675 #, no-wrap msgid "ppp ON example> set authkey mypassword\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:678 msgid "" "Where _mypassword_ should be replaced with the password that was assigned by " "the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:684 msgid "" "If a connection is established, but cannot seem to find any domain name, try " "to man:ping[8] an IP address. If there is 100 percent (100%) packet loss, " "it is likely that a default route was not assigned. Double check that `add " "default HISADDR` was set during the connection. If a connection can be made " "to a remote IP address, it is possible that a resolver address has not been " "added to [.filename]#/etc/resolv.conf#. This file should look like:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:690 #, no-wrap msgid "" "domain example.com\n" "nameserver x.x.x.x\n" "nameserver y.y.y.y\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:693 msgid "" "Where _x.x.x.x_ and _y.y.y.y_ should be replaced with the IP address of the " "ISP's DNS servers." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:695 msgid "" "To configure man:syslog[3] to provide logging for the PPP connection, make " "sure this line exists in [.filename]#/etc/syslog.conf#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:700 #, no-wrap msgid "" "!ppp\n" "*.* /var/log/ppp.log\n" msgstr "" #. type: Title == #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:703 #, no-wrap msgid "Using PPP over Ethernet (PPPoE)" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:706 msgid "This section describes how to set up PPP over Ethernet (PPPoE)." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:708 msgid "Here is an example of a working [.filename]#ppp.conf#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:714 #, no-wrap msgid "" "default:\n" " set log Phase tun command # add more detailed logging when needed\n" " set ifaddr 10.0.0.1/0 10.0.0.2/0\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:722 #, no-wrap msgid "" "name_of_service_provider:\n" " set device PPPoE:xl1 # replace xl1 with the Ethernet device\n" " set authname THELOGINNAME\n" " set authkey THEPASSWORD\n" " set dial\n" " set login\n" " add default HISADDR\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:725 msgid "As `root`, run:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:729 #, no-wrap msgid "# ppp -ddial name_of_service_provider\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:732 msgid "Add the following to [.filename]#/etc/rc.conf#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:739 #, no-wrap msgid "" "ppp_enable=\"YES\"\n" "ppp_mode=\"ddial\"\n" "ppp_nat=\"YES\"\t# when needing to enable nat for the local network, otherwise NO\n" "ppp_profile=\"name_of_service_provider\"\n" msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:741 #, no-wrap msgid "Using a PPPoE Service Tag" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:745 msgid "" "Sometimes it will be necessary to use a service tag to establish the " "connection. Service tags are used to distinguish between different PPPoE " "servers attached to a given network." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:747 msgid "" "Any required service tag information should be in the documentation provided " "by the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:754 msgid "" "As a last resort, one could try installing the package:net/rr-pppoe[] " "package or port. Bear in mind however, this may de-program the modem and " "render it useless, so think twice before doing it. Simply install the " "program shipped with the modem. Then, access the menu:System[] menu from " "the program. The name of the profile should be listed there. It is usually " "_ISP_." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:757 msgid "" "The profile name (service tag) will be used in the PPPoE configuration entry " "in [.filename]#ppp.conf# as the provider part for `set device`. Refer to " "man:ppp[8] for full details. It should look like this:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:761 #, no-wrap msgid "set device PPPoE:xl1:ISP\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:764 msgid "" "Do not forget to change _xl1_ to the proper device for the Ethernet card." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:766 msgid "Do not forget to change _ISP_ to the profile." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:768 msgid "" "For additional information, refer to http://renaud.waldura.com/doc/freebsd/" "pppoe/[Cheaper Broadband with FreeBSD on DSL] by Renaud Waldura." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:770 #, no-wrap msgid "PPPoE with a 3Com(R) HomeConnect(TM) ADSL Modem Dual Link" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:773 msgid "" "This modem does not follow the PPPoE specification defined in http://" "www.faqs.org/rfcs/rfc2516.html[RFC 2516]." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:776 msgid "" "In order to make FreeBSD capable of communicating with this device, a sysctl " "must be set. This can be done automatically at boot time by updating " "[.filename]#/etc/sysctl.conf#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:780 #, no-wrap msgid "net.graph.nonstandard_pppoe=1\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:783 msgid "or can be done immediately with the command:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:787 #, no-wrap msgid "# sysctl net.graph.nonstandard_pppoe=1\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:790 msgid "" "Unfortunately, because this is a system-wide setting, it is not possible to " "talk to a normal PPPoE client or server and a 3Com(R) HomeConnect(TM) ADSL " "Modem at the same time." msgstr "" #. type: Title == #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:792 #, no-wrap msgid "Using PPP over ATM (PPPoA)" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:796 msgid "" "The following describes how to set up PPP over ATM (PPPoA). PPPoA is a " "popular choice among European DSL providers." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:797 #, no-wrap msgid "Using mpd" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:802 msgid "" "The mpd application can be used to connect to a variety of services, in " "particular PPTP services. It can be installed using the package:net/mpd5[] " "package or port. Many ADSL modems require that a PPTP tunnel is created " "between the modem and computer." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:808 msgid "" "Once installed, configure mpd to suit the provider's settings. The port " "places a set of sample configuration files which are well documented in " "[.filename]#/usr/local/etc/mpd/#. A complete guide to configure mpd is " "available in HTML format in [.filename]#/usr/ports/shared/doc/mpd/#. Here " "is a sample configuration for connecting to an ADSL service with mpd. The " "configuration is spread over two files, first the [.filename]#mpd.conf#:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:812 msgid "This example [.filename]#mpd.conf# only works with mpd 4.x." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:818 #, no-wrap msgid "" "default:\n" " load adsl\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:824 #, no-wrap msgid "" "adsl:\n" " new -i ng0 adsl adsl\n" " set bundle authname username <.>\n" " set bundle password password <.>\n" " set bundle disable multilink\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:829 #, no-wrap msgid "" " set link no pap acfcomp protocomp\n" " set link disable chap\n" " set link accept chap\n" " set link keep-alive 30 10\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:832 #, no-wrap msgid "" " set ipcp no vjcomp\n" " set ipcp ranges 0.0.0.0/0 0.0.0.0/0\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:837 #, no-wrap msgid "" " set iface route default\n" " set iface disable on-demand\n" " set iface enable proxy-arp\n" " set iface idle 0\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:839 #, no-wrap msgid " open\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:842 msgid "The username used to authenticate with the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:843 msgid "The password used to authenticate with the ISP." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:846 msgid "" "Information about the link, or links, to establish is found in " "[.filename]#mpd.links#. An example [.filename]#mpd.links# to accompany the " "above example is given beneath:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:855 #, no-wrap msgid "" "adsl:\n" " set link type pptp\n" " set pptp mode active\n" " set pptp enable originate outcall\n" " set pptp self 10.0.0.1 <.>\n" " set pptp peer 10.0.0.138 <.>\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:858 msgid "The IP address of FreeBSD computer running mpd." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:859 msgid "" "The IP address of the ADSL modem. The Alcatel SpeedTouch(TM) Home defaults " "to `10.0.0.138`." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:861 msgid "" "It is possible to initialize the connection easily by issuing the following " "command as `root`:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:865 #, no-wrap msgid "# mpd -b adsl\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:868 msgid "To view the status of the connection:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:874 #, no-wrap msgid "" "% ifconfig ng0\n" "ng0: flags=88d1 mtu 1500\n" " inet 216.136.204.117 --> 204.152.186.171 netmask 0xffffffff\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:877 msgid "" "Using mpd is the recommended way to connect to an ADSL service with FreeBSD." msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:878 #, no-wrap msgid "Using pptpclient" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:881 msgid "" "It is also possible to use FreeBSD to connect to other PPPoA services using " "package:net/pptpclient[]." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:885 msgid "" "To use package:net/pptpclient[] to connect to a DSL service, install the " "port or package, then edit [.filename]#/etc/ppp/ppp.conf#. An example " "section of [.filename]#ppp.conf# is given below. For further information on " "[.filename]#ppp.conf# options consult man:ppp[8]." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:896 #, no-wrap msgid "" "adsl:\n" " set log phase chat lcp ipcp ccp tun command\n" " set timeout 0\n" " enable dns\n" " set authname username <.>\n" " set authkey password <.>\n" " set ifaddr 0 0\n" " add default HISADDR\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:899 msgid "The username for the DSL provider." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:900 msgid "The password for the account." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:905 msgid "" "Since the account's password is added to [.filename]#ppp.conf# in plain text " "form, make sure nobody can read the contents of this file:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:910 #, no-wrap msgid "" "# chown root:wheel /etc/ppp/ppp.conf\n" "# chmod 600 /etc/ppp/ppp.conf\n" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:919 msgid "" "This will open a tunnel for a PPP session to the DSL router. Ethernet DSL " "modems have a preconfigured LAN IP address to connect to. In the case of " "the Alcatel SpeedTouch(TM) Home, this address is `10.0.0.138`. The router's " "documentation should list the address the device uses. To open the tunnel " "and start a PPP session:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:923 #, no-wrap msgid "# pptp address adsl\n" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:929 msgid "" "If an ampersand (\"&\") is added to the end of this command, pptp will " "return the prompt." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:933 msgid "" "A [.filename]#tun# virtual tunnel device will be created for interaction " "between the pptp and ppp processes. Once the prompt is returned, or the " "pptp process has confirmed a connection, examine the tunnel:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:940 #, no-wrap msgid "" "% ifconfig tun0\n" "tun0: flags=8051 mtu 1500\n" " inet 216.136.204.21 --> 204.152.186.171 netmask 0xffffff00\n" "\tOpened by PID 918\n" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ppp-and-slip/_index.adoc:943 msgid "" "If the connection fails, check the configuration of the router, which is " "usually accessible using a web browser. Also, examine the output of `pptp` " "and the contents of the log file, [.filename]#/var/log/ppp.log# for clues." msgstr ""