1 From a30efa2cc99a5b6ab220de04cbcc7db38888a17a Mon Sep 17 00:00:00 2001
2 From: Michal Sekletar <msekleta@redhat.com>
3 Date: Mon, 7 Apr 2014 14:29:45 +0200
4 Subject: [PATCH 16/25] rp-pppoe: add manpage for pppoe-discovery
7 pppd/plugins/rp-pppoe/Makefile.linux | 2 +
8 pppd/plugins/rp-pppoe/pppoe-discovery.8 | 86 +++++++++++++++++++++++++++++++++
9 2 files changed, 88 insertions(+)
10 create mode 100644 pppd/plugins/rp-pppoe/pppoe-discovery.8
12 diff --git a/pppd/plugins/rp-pppoe/Makefile.linux b/pppd/plugins/rp-pppoe/Makefile.linux
13 index 3cd9101..9918091 100644
14 --- a/pppd/plugins/rp-pppoe/Makefile.linux
15 +++ b/pppd/plugins/rp-pppoe/Makefile.linux
18 DESTDIR = $(INSTROOT)@DESTDIR@
19 BINDIR = $(DESTDIR)/sbin
20 +MANDIR = $(DESTDIR)/share/man/man8
21 LIBDIR = $(DESTDIR)/lib/$(shell gcc -print-multi-os-directory 2> /dev/null)/pppd/$(PPPDVERSION)
23 PPPDVERSION = $(shell awk -F '"' '/VERSION/ { print $$2; }' ../../patchlevel.h)
24 @@ -46,6 +47,7 @@ install: all
25 $(INSTALL) -c -m 4550 rp-pppoe.so $(LIBDIR)
26 $(INSTALL) -d -m 755 $(BINDIR)
27 $(INSTALL) -c -m 555 pppoe-discovery $(BINDIR)
28 + $(INSTALL) -c -m 444 pppoe-discovery.8 $(MANDIR)
31 rm -f *.o *.so pppoe-discovery
32 diff --git a/pppd/plugins/rp-pppoe/pppoe-discovery.8 b/pppd/plugins/rp-pppoe/pppoe-discovery.8
34 index 0000000..d0a93db
36 +++ b/pppd/plugins/rp-pppoe/pppoe-discovery.8
38 +.\" pppoe-discovery.8 written by
39 +.\" Ben Hutchings <ben@decadentplace.org.uk>, based on pppoe.8.
40 +.\" Licenced under the GPL version 2 or later.
41 +.TH PPPOE-DISCOVERY 8
43 +pppoe\-discovery \- perform PPPoE discovery
50 +.BR pppoe\-discovery " { " \-V " | " \-h " }"
53 +\fBpppoe\-discovery\fR performs the same discovery process as
54 +\fBpppoe\fR, but does not initiate a session.
55 +It sends a PADI packet and then prints the names of access
56 +concentrators in each PADO packet it receives.
61 +The \fB\-I\fR option specifies the Ethernet interface to use.
62 +Under Linux, it is typically eth0 or eth1.
63 +The interface should be \(lqup\(rq before you start
64 +\fBpppoe\-discovery\fR, but should \fInot\fR be configured to have an
66 +The default interface is eth0.
71 +The \fB\-D\fR option causes every packet to be dumped to the specified
73 +This is intended for debugging only.
78 +Causes \fBpppoe\-discovery\fR to use the Host-Uniq tag in its discovery
80 +This lets you run multiple instances of \fBpppoe\-discovery\fR and/or
81 +\fBpppoe\fR without having their discovery packets interfere with one
83 +You must supply this option to \fIall\fR instances that you intend to
87 +.BI \-S " service_name"
89 +Specifies the desired service name.
90 +\fBpppoe\-discovery\fR will only accept access concentrators which can
91 +provide the specified service.
92 +In most cases, you should \fInot\fR specify this option.
93 +Use it only if you know that there are multiple access concentrators
94 +or know that you need a specific service name.
99 +Specifies the desired access concentrator name.
100 +\fBpppoe\-discovery\fR will only accept the specified access
102 +In most cases, you should \fInot\fR specify this option.
103 +Use it only if you know that there are multiple access concentrators.
104 +If both the \fB\-S\fR and \fB\-C\fR options are specified, they must
110 +This option is accepted for compatibility with \fBpppoe\fR, but has no
116 +Either of these options causes \fBpppoe\-discovery\fR to print its
117 +version number and usage information, then exit.
120 +\fBpppoe\-discovery\fR was written by Marco d'Itri <md@linux.it>,
121 +based on \fBpppoe\fR by David F. Skoll <dfs@roaringpenguin.com>.
123 +pppoe(8), pppoe-sniff(8)