Difference between pages "Help:Bots" and "PPPoE"

(Difference between pages)
 
(Kernel options)
 
Line 1: Line 1:
{{PD Help Page}}
+
This page expains how to setup and configue '''PPPoE''' connection with rp-pppoe and Funtoo Linux network.
 +
== Kernel options ==
 +
Make sure following kernel options are enabled
  
A '''bot''' is a computer program that automatically retrieves or updates wiki pages when it is executed. In general, bots are used for repetitive maintenance tasks, whose volume and characteristics are too large to be performed manually by users.
+
{{File
 +
|/usr/src/linux/.config|<pre>
 +
# zgrep PPP /proc/config.gz
 +
CONFIG_PPP=m
 +
CONFIG_PPP_BSDCOMP=m
 +
# CONFIG_PPP_DEFLATE is not set
 +
CONFIG_PPP_FILTER=y
 +
CONFIG_PPP_MPPE=m
 +
CONFIG_PPP_MULTILINK=y
 +
CONFIG_PPPOE=m
 +
CONFIG_PPP_ASYNC=m
 +
CONFIG_PPP_SYNC_TTY=m
 +
</pre>}}
 +
Next, we configure and install {{Package|net-dialup/rp-pppoe}}:
 +
<console>
 +
###i## emerge rp-pppoe
 +
###i## pppoe-setup
 +
</console>
 +
Configuration is straightforward, setup username, password and ethernet interface to use, in our example it is <code>eth2</code>.
  
Developing and executing bots is normally outside the role of normal users, requires programming experience and must be done in coordination with the wiki's [[Help:Sysops and permissions|admins]].  
+
== Funtoo Linux network setup ==
 +
Funtoo openrc does not provide default template for ppp connections. We will create a custom template.
 +
<console># ##i##cd /etc/netif.d/</console>
 +
Create <code>interface-pppoe</code>
 +
{{File
 +
|interface-pppoe|<pre>
 +
#!/bin/sh
 +
netif_pre_up() {
 +
pppoe-connect >/var/log/pppoe.log 2>&1 &
 +
}
 +
netif_pre_down() {
 +
pppoe-stop
 +
}
 +
</pre>}}
 +
Now we will create a <code>eth2</code> interface as follows:
 +
<console>
 +
# ##i##cd /etc/init.d
 +
# ##i##ln -s netif.tmpl netif.eth2
 +
</console>
 +
Then create an <code>/etc/conf.d/netif.eth2</code> configuration file that would specify a pppoe template in <code>/etc/netif.d</code> directory:
 +
{{File
 +
|/etc/conf.d/netif.eth2|<pre>
 +
template="interface-pppoe"
 +
description="Your ISP"
 +
</pre>}}
 +
To complete configuration add an interface to default runlevel:
 +
<console> # ##i##rc-update add netif.eth2 default</console>
  
By default, bot edits are hidden in [[Special:RecentChanges|{{ns:special}}:{{MediaWiki:Recentchanges}}]].
+
[[Category:Networking]]
 
+
[[Category:HOWTO]]
== Framework and interface for bot development ==
+
Bots do not access the wiki through the normal graphical user interface. MediaWiki has an API (Application Programming Interface) available for this purpose. An API is a protocol for standardised communication between two computer programs. Check {{mediawiki|API:Client code}} for more information.
+
 
+
To access a wiki through the API a bot must have a user account, which has been granted 'bot' [[Help:Assigning permissions|permissions]].
+
 
+
=== pywikipediabot ===
+
{{mediawiki|meta:pywikipediabot}} provides a framework for the development of bots, which are commonly used to perform maintenance tasks such as adding a footer to some categorized pages ({{mediawiki|meta:pywikipediabot/add_text.py|add_text.py}}), adding some [[Help:Links|wikilinks]] ({{mediawiki|meta:pywikipediabot/replace.py|replace.py}}), moving old contents of [[Help:Talk pages|talk pages]] to [[Help:Subpages|subpages]] ({{mediawiki|meta:pywikipediabot/archivebot.py|archivebot.py}}), editing [[Help:Categories|categories]] ({{mediawiki|meta:pywikipediabot/category.py|category.py}}), or managing [[Help:Templates|templates]] ({{mediawiki|meta:pywikipediabot/template.py|template.py}}).
+
 
+
== The MassEditRegex extension ==
+
[[:mw:Extension:MassEditRegex|Extension:MassEditRegex]] provides an alternative way to perform mass edits using regular expressions, through a special page in the wiki. Only admins can normally use this extension.
+
 
+
== See also ==
+
* {{mediawiki|meta:Bot}}
+
 
+
{{Languages}}
+
 
+
[[Category:Help|{{PAGENAME}}]]
+

Revision as of 20:52, 28 January 2014

This page expains how to setup and configue PPPoE connection with rp-pppoe and Funtoo Linux network.

Kernel options

Make sure following kernel options are enabled

{{{name}}}
{{{body}}}

Next, we configure and install net-dialup/rp-pppoe:

# emerge rp-pppoe
# pppoe-setup

Configuration is straightforward, setup username, password and ethernet interface to use, in our example it is eth2.

Funtoo Linux network setup

Funtoo openrc does not provide default template for ppp connections. We will create a custom template.

# cd /etc/netif.d/

Create interface-pppoe

{{{name}}}
{{{body}}}

Now we will create a eth2 interface as follows:

# cd /etc/init.d
# ln -s netif.tmpl netif.eth2

Then create an /etc/conf.d/netif.eth2 configuration file that would specify a pppoe template in /etc/netif.d directory:

{{{name}}}
{{{body}}}

To complete configuration add an interface to default runlevel:

 # rc-update add netif.eth2 default