pppoe-discovery: add options to tune discovery timeout and attempts
[ppp.git] / README.pwfd
1
2         Support to pass the password via a pipe to the pppd
3         ---------------------------------------------------
4
5         Arvin Schnell <arvin@suse.de>
6         2002-02-08
7
8
9 1. Introduction
10 ---------------
11
12 Normally programs like wvdial or kppp read the online password from their
13 config file and store them in the pap- and chap-secrets before they start the
14 pppd and remove them afterwards. Sure they need special privileges to do so.
15
16 The passwordfd feature offers a simpler and more secure solution. The program
17 that starts the pppd opens a pipe and writes the password into it. The pppd
18 simply reads the password from that pipe.
19
20 This methods is used for quite a while on SuSE Linux by the programs wvdial,
21 kppp and smpppd.
22
23
24 2. Example
25 ----------
26
27 Here is a short C program that uses the passwordfd feature. It starts the pppd
28 to buildup a pppoe connection.
29
30
31 --snip--
32
33 #include <stdio.h>
34 #include <stdlib.h>
35 #include <unistd.h>
36 #include <signal.h>
37 #include <string.h>
38 #include <paths.h>
39
40 #ifndef _PATH_PPPD
41 #define _PATH_PPPD "/usr/sbin/pppd"
42 #endif
43
44
45 // Of course these values can be read from a configuration file or
46 // entered in a graphical dialog.
47 char *device = "eth0";
48 char *username = "1122334455661122334455660001@t-online.de";
49 char *password = "hello";
50
51 pid_t pid = 0;
52
53
54 void
55 sigproc (int src)
56 {
57     fprintf (stderr, "Sending signal %d to pid %d\n", src, pid);
58     kill (pid, src);
59     exit (EXIT_SUCCESS);
60 }
61
62
63 void
64 sigchild (int src)
65 {
66     fprintf (stderr, "Daemon died\n");
67     exit (EXIT_SUCCESS);
68 }
69
70
71 int
72 start_pppd ()
73 {
74     signal (SIGINT, &sigproc);
75     signal (SIGTERM, &sigproc);
76     signal (SIGCHLD, &sigchild);
77
78     pid = fork ();
79     if (pid < 0) {
80         fprintf (stderr, "unable to fork() for pppd: %m\n");
81         return 0;
82     }
83
84     if (pid == 0) {
85
86         int i, pppd_argc = 0;
87         char *pppd_argv[20];
88         char buffer[32] = "";
89         int pppd_passwdfd[2];
90
91         for (i = 0; i < 20; i++)
92             pppd_argv[i] = NULL;
93
94         pppd_argv[pppd_argc++] = "pppd";
95
96         pppd_argv[pppd_argc++] = "call";
97         pppd_argv[pppd_argc++] = "pwfd-test";
98
99         // The device must be after the call, since the call loads the plugin.
100         pppd_argv[pppd_argc++] = device;
101
102         pppd_argv[pppd_argc++] = "user";
103         pppd_argv[pppd_argc++] = username;
104
105         // Open a pipe to pass the password to pppd.
106         if (pipe (pppd_passwdfd) == -1) {
107             fprintf (stderr, "pipe failed: %m\n");
108             exit (EXIT_FAILURE);
109         }
110
111         // Of course this only works it the password is shorter
112         // than the pipe buffer. Otherwise you have to fork to
113         // prevent that your main program blocks.
114         write (pppd_passwdfd[1], password, strlen (password));
115         close (pppd_passwdfd[1]);
116
117         // Tell the pppd to read the password from the fd.
118         pppd_argv[pppd_argc++] = "passwordfd";
119         snprintf (buffer, 32, "%d", pppd_passwdfd[0]);
120         pppd_argv[pppd_argc++] = buffer;
121
122         if (execv (_PATH_PPPD, (char **) pppd_argv) < 0) {
123             fprintf (stderr, "cannot execl %s: %m\n", _PATH_PPPD);
124             exit (EXIT_FAILURE);
125         }
126     }
127
128     pause ();
129
130     return 1;
131 }
132
133
134 int
135 main (int argc, char **argv)
136 {
137     if (start_pppd ())
138         exit (EXIT_SUCCESS);
139
140     exit (EXIT_FAILURE);
141 }
142
143 ---snip---
144
145
146 Copy this file to /etc/ppp/peers/pwfd-test. The plugins can't be loaded on the
147 command line (unless you are root) since the plugin option is privileged.
148
149
150 ---snip---
151
152 #
153 # PPPoE plugin for kernel 2.4
154 #
155 plugin pppoe.so
156
157 #
158 # This plugin enables us to pipe the password to pppd, thus we don't have
159 # to fiddle with pap-secrets and chap-secrets. The user is also passed
160 # on the command line.
161 #
162 plugin passwordfd.so
163
164 noauth
165 usepeerdns
166 defaultroute
167 hide-password
168 nodetach
169 nopcomp
170 novjccomp
171 noccp
172
173 ---snip---
174