summaryrefslogtreecommitdiffstats
path: root/mdk-stage1/rp-pppoe/gui/pppoe-wrapper.1
blob: 4fbf2bce26d95022d9c3825f5a12e70daca330ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
.\" $Id$ 
.TH PPPOE-WRAPPER 1 "26 February 2001"
.UC 4
.SH NAME
pppoe-wrapper \- SUID wrapper for starting and stopping PPPoE connections.
.SH SYNOPSIS
.B pppoe-wrapper start linkname
.P
.B pppoe-wrapper stop linkname
.P
.B pppoe-wrapper status linkname

.SH DESCRIPTION
\fBpppoe-wrapper\fR is a small SUID program which allows non-root users
to start and stop PPPoE links.  It operates as follows:

.TP
.B o
First, \fIlinkname\fR is sanity-checked.  Too-long names and names containing
illegal characters are rejected.

.TP
.B o
Second, \fBpppoe-wrapper\fR opens the file \fB/etc/ppp/rp-pppoe-gui/\fR\fIlinkname\fR for reading.  If that file does not contain the line:
.nf

		NONROOT=OK

.fi
then \fBpppoe-wrapper\fR fails.

.TP
.B o
Otherwise, \fBpppoe-wrapper\fR runs \fBadsl-start\fR, \fBadsl-stop\fR or
\fBadsl-status\fR with the above filename as its single argument.

.SH AUTHOR
\fBpppoe-wrapper\fR was written by David F. Skoll <dfs@roaringpenguin.com>.

The \fBpppoe\fR home page is \fIhttp://www.roaringpenguin.com/pppoe/\fR.

.SH SEE ALSO
adsl-start(8), adsl-stop(8), adsl-status(8), tkpppoe(1)