{"id":4661,"date":"2022-12-20T18:09:30","date_gmt":"2022-12-20T21:09:30","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/pppoe-conf-man5\/"},"modified":"2022-12-20T18:09:30","modified_gmt":"2022-12-20T21:09:30","slug":"pppoe-conf-man5","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/pppoe-conf-man5\/","title":{"rendered":"PPPOE.CONF (man5)"},"content":{"rendered":"<h1 align=\"center\">PPPOE.CONF<\/h1>\n<p> <a href=\"#NAME\">NAME<\/a><br \/> <a href=\"#DESCRIPTION\">DESCRIPTION<\/a><br \/> <a href=\"#SEE ALSO\">SEE ALSO<\/a> <\/p>\n<hr>\n<h2>NAME <a name=\"NAME\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">pppoe.conf \u2212 Configuration file used by <b>pppoe-start<\/b>(8), <b>pppoe-stop<\/b>(8), <b>pppoe-status(8)<\/b> and <b>pppoe-connect<\/b>(8).<\/p>\n<h2>DESCRIPTION <a name=\"DESCRIPTION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>\/etc\/ppp\/pppoe.conf<\/b> is a shell script which contains configuration information for Roaring Penguin\u2019s PPPoE scripts. Note that <b>pppoe.conf<\/b> is used only by the various pppoe-* shell scripts, not by <b>pppoe<\/b> itself.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>pppoe.conf<\/b> consists of a sequence of shell variable assignments. The variables and their meanings are:<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"6%\">\n<p><b>ETH<\/b><\/p>\n<\/td>\n<td width=\"5%\"><\/td>\n<td width=\"78%\">\n<p>The Ethernet interface connected to the DSL modem (for example, eth0).<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"6%\">\n<p><b>USER<\/b><\/p>\n<\/td>\n<td width=\"5%\"><\/td>\n<td width=\"78%\">\n<p>The PPPoE user-id (for example, b1xxnxnx@sympatico.ca).<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:11%;\"><b>SERVICENAME<\/b><\/p>\n<p style=\"margin-left:22%;\">If this is not blank, then it is passed with the <b>\u2212S<\/b> option to <b>pppoe<\/b>. It specifies a service name to ask for. Usually, you should leave it blank.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"9%\">\n<p><b>ACNAME<\/b><\/p>\n<\/td>\n<td width=\"2%\"><\/td>\n<td width=\"78%\">\n<p>If this is not blank, then it is passed with the <b>\u2212C<\/b> option to <b>pppoe<\/b>. It specifies the name of the access concentrator to connect to. Usually, you should leave it blank.<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"9%\">\n<p><b>DEMAND<\/b><\/p>\n<\/td>\n<td width=\"2%\"><\/td>\n<td width=\"78%\">\n<p>If set to a number, the link is activated on demand and brought down after after <b>DEMAND<\/b> seconds. If set to <b>no<\/b>, the link is kept up all the time rather than being activated on demand.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:11%;\"><b>DNSTYPE<\/b><\/p>\n<p style=\"margin-left:22%;\">One of <b>NOCHANGE<\/b>, <b>SPECIFY<\/b> or <b>SERVER<\/b>. If set to NOCHANGE, <b>pppoe-connect<\/b> will not adjust the DNS setup in any way. If set to SPECIFY, it will re-write \/etc\/resolv.conf with the values of DNS1 and DNS2. If set to <b>SERVER<\/b>, it will supply the <i>usepeerdns<\/i> option to <b>pppd<\/b>, and make a symlink from \/etc\/resolv.conf to \/etc\/ppp\/resolv.conf.<\/p>\n<p style=\"margin-left:11%;\"><b>DNS1, DNS2<\/b><\/p>\n<p style=\"margin-left:22%;\">IP addresses of DNS servers if you use DNSTYPE=SPECIFY.<\/p>\n<p style=\"margin-left:11%;\"><b>NONROOT<\/b><\/p>\n<p style=\"margin-left:22%;\">If the line <b>NONROOT=OK<\/b> (exactly like that; no whitespace or comments) appears in the configuration file, then <b>pppoe-wrapper<\/b> will allow non-root users to bring the conneciton up or down. The wrapper is installed only if you installed the rp-pppoe-gui package.<\/p>\n<p style=\"margin-left:11%;\"><b>USEPEERDNS<\/b><\/p>\n<p style=\"margin-left:22%;\">If set to &#8220;yes&#8221;, then <b>pppoe-connect<\/b> will supply the <i>usepeerdns<\/i> option to <b>pppd<\/b>, which causes it to obtain DNS server addresses from the peer and create a new <b>\/etc\/resolv.conf<\/b> file. Otherwise, <b>pppoe-connect<\/b> will not supply this option, and <b>pppd<\/b> will not modify <b>\/etc\/resolv.conf<\/b>.<\/p>\n<p style=\"margin-left:11%;\"><b>CONNECT_POLL<\/b><\/p>\n<p style=\"margin-left:22%;\">How often (in seconds) <b>pppoe-start<\/b> should check to see if a new PPP interface has come up. If this is set to 0, the <b>pppoe-start<\/b> simply initiates the PPP session, but does not wait to see if it comes up successfully.<\/p>\n<p style=\"margin-left:11%;\"><b>CONNECT_TIMEOUT<\/b><\/p>\n<p style=\"margin-left:22%;\">How long (in seconds) <b>pppoe-start<\/b> should wait for a new PPP interface to come up before concluding that <b>pppoe-connect<\/b> has failed and killing the session.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"6%\">\n<p><b>PING<\/b><\/p>\n<\/td>\n<td width=\"5%\"><\/td>\n<td width=\"78%\">\n<p>A character which is echoed every <b>CONNECT_POLL<\/b> seconds while <b>pppoe-start<\/b> is waiting for the PPP interface to come up.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:11%;\"><b>FORCEPING<\/b><\/p>\n<p style=\"margin-left:22%;\">A character which is echoed every <b>CONNECT_POLL<\/b> seconds while <b>pppoe-start<\/b> is waiting for the PPP interface to come up. Similar to <b>PING<\/b>, but the character is echoed even if <b>pppoe-start<\/b>\u2019s standard output is not a tty.<\/p>\n<p style=\"margin-left:11%;\"><b>PIDFILE<\/b><\/p>\n<p style=\"margin-left:22%;\">A file in which to write the process-ID of the pppoe-connect process (for example, <b>\/var\/run\/pppoe.pid<\/b>). Two additional files ($PIDFILE.pppd and $PIDFILE.pppoe) hold the process-ID\u2019s of the <b>pppd<\/b> and <b>pppoe<\/b> processes, respectively.<\/p>\n<p style=\"margin-left:11%;\"><b>SYNCHRONOUS<\/b><\/p>\n<p style=\"margin-left:22%;\">An indication of whether or not to use synchronous PPP (<b>yes<\/b> or <b>no<\/b>). Synchronous PPP is safe on Linux machines with the n_hdlc line discipline. (If you have a file called &#8220;n_hdlc.o&#8221; in your modules directory, you have the line discipline.) It is <i>not recommended<\/i> on other machines or on Linux machines without the n_hdlc line discipline due to some known and unsolveable race conditions in a user-mode client.<\/p>\n<p style=\"margin-left:11%;\"><b>CLAMPMSS<\/b><\/p>\n<p style=\"margin-left:22%;\">The value at which to &#8220;clamp&#8221; the advertised MSS for TCP sessions. The default of 1412 should be fine.<\/p>\n<p style=\"margin-left:11%;\"><b>LCP_INTERVAL<\/b><\/p>\n<p style=\"margin-left:22%;\">How often (in seconds) <b>pppd<\/b> sends out LCP echo-request packets.<\/p>\n<p style=\"margin-left:11%;\"><b>LCP_FAILURE<\/b><\/p>\n<p style=\"margin-left:22%;\">How many unanswered LCP echo-requests must occur before <b>pppd<\/b> concludes the link is dead.<\/p>\n<p style=\"margin-left:11%;\"><b>PPPOE_TIMEOUT<\/b><\/p>\n<p style=\"margin-left:22%;\">If this many seconds elapse without any activity seen by <b>pppoe<\/b>, then <b>pppoe<\/b> exits.<\/p>\n<p style=\"margin-left:11%;\"><b>FIREWALL<\/b><\/p>\n<p style=\"margin-left:22%;\">One of NONE, STANDALONE or MASQUERADE. If NONE, then <b>pppoe-connect<\/b> does not add any firewall rules. If STANDALONE, then it clears existing firewall rules and sets up basic rules for a standalone machine. If MASQUERADE, then it clears existing firewall rules and sets up basic rules for an Internet gateway. If you run services on your machine, these simple firewall scripts are inadequate; you\u2019ll have to make your own firewall rules and set FIREWALL to NONE.<\/p>\n<p style=\"margin-left:11%;\"><b>PPPOE_EXTRA<\/b><\/p>\n<p style=\"margin-left:22%;\">Any extra arguments to pass to <b>pppoe<\/b><\/p>\n<p style=\"margin-left:11%;\"><b>PPPD_EXTRA<\/b><\/p>\n<p style=\"margin-left:22%;\">Any extra arguments to pass to <b>pppd<\/b><\/p>\n<p style=\"margin-left:11%;\"><b>LINUX_PLUGIN<\/b><\/p>\n<p style=\"margin-left:22%;\">If non-blank, the full path of the Linux kernel-mode PPPoE plugin (typically <b>\/etc\/ppp\/plugins\/rp-pppoe.so<\/b>.) This forces <b>pppoe-connect<\/b> to use kernel-mode PPPoE on Linux 2.4.x systems. This code is experimental and unsupported. Use of the plugin causes <b>pppoe-connect<\/b> to ignore CLAMPMSS, PPPOE_EXTRA, SYNCHRONOUS and PPPOE_TIMEOUT.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">By using different configuration files with different PIDFILE settings, you can manage multiple PPPoE connections. Just specify the configuration file as an argument to <b>pppoe-start<\/b> and <b>pppoe-stop<\/b>.<\/p>\n<h2>SEE ALSO <a name=\"SEE ALSO\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">pppoe(8), pppoe-connect(8), pppoe-start(8), pppoe-stop(8), pppd(8), pppoe-setup(8), pppoe-wrapper(8)<\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>  pppoe.conf \u2212 Configuration file used by pppoe-start(8), pppoe-stop(8), pppoe-status(8) and pppoe-connect(8). <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[959],"tags":[961,1291,552],"class_list":["post-4661","post","type-post","status-publish","format-standard","hentry","category-5-formatos-de-ficheros","tag-961","tag-man5","tag-pppoe"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4661","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=4661"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4661\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=4661"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=4661"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=4661"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}