Initial public busybox upstream commit
[busybox4maemo] / networking / zcip.c
1 /* vi: set sw=4 ts=4: */
2 /*
3  * RFC3927 ZeroConf IPv4 Link-Local addressing
4  * (see <http://www.zeroconf.org/>)
5  *
6  * Copyright (C) 2003 by Arthur van Hoff (avh@strangeberry.com)
7  * Copyright (C) 2004 by David Brownell
8  *
9  * Licensed under the GPL v2 or later, see the file LICENSE in this tarball.
10  */
11
12 /*
13  * ZCIP just manages the 169.254.*.* addresses.  That network is not
14  * routed at the IP level, though various proxies or bridges can
15  * certainly be used.  Its naming is built over multicast DNS.
16  */
17
18 //#define DEBUG
19
20 // TODO:
21 // - more real-world usage/testing, especially daemon mode
22 // - kernel packet filters to reduce scheduling noise
23 // - avoid silent script failures, especially under load...
24 // - link status monitoring (restart on link-up; stop on link-down)
25
26 #include <netinet/ether.h>
27 #include <net/ethernet.h>
28 #include <net/if.h>
29 #include <net/if_arp.h>
30 #include <linux/if_packet.h>
31 #include <linux/sockios.h>
32
33 #include "libbb.h"
34 #include <syslog.h>
35
36 /* We don't need more than 32 bits of the counter */
37 #define MONOTONIC_US() ((unsigned)monotonic_us())
38
39 struct arp_packet {
40         struct ether_header eth;
41         struct ether_arp arp;
42 } ATTRIBUTE_PACKED;
43
44 enum {
45 /* 169.254.0.0 */
46         LINKLOCAL_ADDR = 0xa9fe0000,
47
48 /* protocol timeout parameters, specified in seconds */
49         PROBE_WAIT = 1,
50         PROBE_MIN = 1,
51         PROBE_MAX = 2,
52         PROBE_NUM = 3,
53         MAX_CONFLICTS = 10,
54         RATE_LIMIT_INTERVAL = 60,
55         ANNOUNCE_WAIT = 2,
56         ANNOUNCE_NUM = 2,
57         ANNOUNCE_INTERVAL = 2,
58         DEFEND_INTERVAL = 10
59 };
60
61 /* States during the configuration process. */
62 enum {
63         PROBE = 0,
64         RATE_LIMIT_PROBE,
65         ANNOUNCE,
66         MONITOR,
67         DEFEND
68 };
69
70 #define VDBG(...) do { } while (0)
71
72
73 enum {
74         sock_fd = 3
75 };
76
77 struct globals {
78         char *intf;
79         struct sockaddr saddr;
80 };
81 #define G (*(struct globals*)&bb_common_bufsiz1)
82 #define intf  (G.intf )
83 #define saddr (G.saddr)
84
85
86 /**
87  * Pick a random link local IP address on 169.254/16, except that
88  * the first and last 256 addresses are reserved.
89  */
90 static void pick(struct in_addr *ip)
91 {
92         unsigned tmp;
93
94         do {
95                 tmp = rand() & IN_CLASSB_HOST;
96         } while (tmp > (IN_CLASSB_HOST - 0x0200));
97         ip->s_addr = htonl((LINKLOCAL_ADDR + 0x0100) + tmp);
98 }
99
100 /**
101  * Broadcast an ARP packet.
102  */
103 static void arp(int op,
104         const struct ether_addr *source_eth, struct in_addr source_ip,
105         const struct ether_addr *target_eth, struct in_addr target_ip)
106 {
107         struct arp_packet p;
108         memset(&p, 0, sizeof(p));
109
110         // ether header
111         p.eth.ether_type = htons(ETHERTYPE_ARP);
112         memcpy(p.eth.ether_shost, source_eth, ETH_ALEN);
113         memset(p.eth.ether_dhost, 0xff, ETH_ALEN);
114
115         // arp request
116         p.arp.arp_hrd = htons(ARPHRD_ETHER);
117         p.arp.arp_pro = htons(ETHERTYPE_IP);
118         p.arp.arp_hln = ETH_ALEN;
119         p.arp.arp_pln = 4;
120         p.arp.arp_op = htons(op);
121         memcpy(&p.arp.arp_sha, source_eth, ETH_ALEN);
122         memcpy(&p.arp.arp_spa, &source_ip, sizeof(p.arp.arp_spa));
123         memcpy(&p.arp.arp_tha, target_eth, ETH_ALEN);
124         memcpy(&p.arp.arp_tpa, &target_ip, sizeof(p.arp.arp_tpa));
125
126         // send it
127         xsendto(sock_fd, &p, sizeof(p), &saddr, sizeof(saddr));
128
129         // Currently all callers ignore errors, that's why returns are
130         // commented out...
131         //return 0;
132 }
133
134 /**
135  * Run a script. argv[2] is already NULL.
136  */
137 static int run(char *argv[3], struct in_addr *ip)
138 {
139         int status;
140         char *addr = addr; /* for gcc */
141         const char *fmt = "%s %s %s" + 3;
142
143         VDBG("%s run %s %s\n", intf, argv[0], argv[1]);
144
145         if (ip) {
146                 addr = inet_ntoa(*ip);
147                 setenv("ip", addr, 1);
148                 fmt -= 3;
149         }
150         bb_info_msg(fmt, argv[1], intf, addr);
151
152         status = wait4pid(spawn(argv));
153         if (status < 0) {
154                 bb_perror_msg("%s %s %s" + 3, argv[1], intf);
155                 return -errno;
156         }
157         if (status != 0)
158                 bb_error_msg("script %s %s failed, exitcode=%d", argv[0], argv[1], status);
159         return status;
160 }
161
162 /**
163  * Return milliseconds of random delay, up to "secs" seconds.
164  */
165 static unsigned ALWAYS_INLINE random_delay_ms(unsigned secs)
166 {
167         return rand() % (secs * 1000);
168 }
169
170 /**
171  * main program
172  */
173 int zcip_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
174 int zcip_main(int argc, char **argv)
175 {
176         int state = PROBE;
177         struct ether_addr eth_addr;
178         char *r_opt;
179         unsigned opts;
180
181         // ugly trick, but I want these zeroed in one go
182         struct {
183                 const struct in_addr null_ip;
184                 const struct ether_addr null_addr;
185                 struct in_addr ip;
186                 struct ifreq ifr;
187                 char *script_av[3];
188                 int timeout_ms; /* must be signed */
189                 unsigned conflicts;
190                 unsigned nprobes;
191                 unsigned nclaims;
192                 int ready;
193                 int verbose;
194         } L;
195 #define null_ip    (L.null_ip   )
196 #define null_addr  (L.null_addr )
197 #define ip         (L.ip        )
198 #define ifr        (L.ifr       )
199 #define script_av  (L.script_av )
200 #define timeout_ms (L.timeout_ms)
201 #define conflicts  (L.conflicts )
202 #define nprobes    (L.nprobes   )
203 #define nclaims    (L.nclaims   )
204 #define ready      (L.ready     )
205 #define verbose    (L.verbose   )
206
207         memset(&L, 0, sizeof(L));
208
209 #define FOREGROUND (opts & 1)
210 #define QUIT       (opts & 2)
211         // parse commandline: prog [options] ifname script
212         // exactly 2 args; -v accumulates and implies -f
213         opt_complementary = "=2:vv:vf";
214         opts = getopt32(argv, "fqr:v", &r_opt, &verbose);
215 #if !BB_MMU
216         // on NOMMU reexec early (or else we will rerun things twice)
217         if (!FOREGROUND)
218                 bb_daemonize_or_rexec(0 /*was: DAEMON_CHDIR_ROOT*/, argv);
219 #endif
220         // open an ARP socket
221         // (need to do it before openlog to prevent openlog from taking
222         // fd 3 (sock_fd==3))
223         xmove_fd(xsocket(AF_PACKET, SOCK_PACKET, htons(ETH_P_ARP)), sock_fd);
224         if (!FOREGROUND) {
225                 // do it before all bb_xx_msg calls
226                 openlog(applet_name, 0, LOG_DAEMON);
227                 logmode |= LOGMODE_SYSLOG;
228         }
229         if (opts & 4) { // -r n.n.n.n
230                 if (inet_aton(r_opt, &ip) == 0
231                  || (ntohl(ip.s_addr) & IN_CLASSB_NET) != LINKLOCAL_ADDR
232                 ) {
233                         bb_error_msg_and_die("invalid link address");
234                 }
235         }
236         argc -= optind;
237         argv += optind;
238
239         intf = argv[0];
240         script_av[0] = argv[1];
241         setenv("interface", intf, 1);
242
243         // initialize the interface (modprobe, ifup, etc)
244         script_av[1] = (char*)"init";
245         if (run(script_av, NULL))
246                 return EXIT_FAILURE;
247
248         // initialize saddr
249         // saddr is: { u16 sa_family; u8 sa_data[14]; }
250         //memset(&saddr, 0, sizeof(saddr));
251         //TODO: are we leaving sa_family == 0 (AF_UNSPEC)?!
252         safe_strncpy(saddr.sa_data, intf, sizeof(saddr.sa_data));
253
254         // bind to the interface's ARP socket
255         xbind(sock_fd, &saddr, sizeof(saddr));
256
257         // get the interface's ethernet address
258         //memset(&ifr, 0, sizeof(ifr));
259         strncpy(ifr.ifr_name, intf, sizeof(ifr.ifr_name));
260         xioctl(sock_fd, SIOCGIFHWADDR, &ifr);
261         memcpy(&eth_addr, &ifr.ifr_hwaddr.sa_data, ETH_ALEN);
262
263         // start with some stable ip address, either a function of
264         // the hardware address or else the last address we used.
265         // we are taking low-order four bytes, as top-order ones
266         // aren't random enough.
267         // NOTE: the sequence of addresses we try changes only
268         // depending on when we detect conflicts.
269         {
270                 uint32_t t;
271                 memcpy(&t, (char*)&eth_addr + 2, 4);
272                 srand(t);
273         }
274         if (ip.s_addr == 0)
275                 pick(&ip);
276
277         // FIXME cases to handle:
278         //  - zcip already running!
279         //  - link already has local address... just defend/update
280
281         // daemonize now; don't delay system startup
282         if (!FOREGROUND) {
283 #if BB_MMU
284                 bb_daemonize(0 /*was: DAEMON_CHDIR_ROOT*/);
285 #endif
286                 bb_info_msg("start, interface %s", intf);
287         }
288
289         // run the dynamic address negotiation protocol,
290         // restarting after address conflicts:
291         //  - start with some address we want to try
292         //  - short random delay
293         //  - arp probes to see if another host uses it
294         //  - arp announcements that we're claiming it
295         //  - use it
296         //  - defend it, within limits
297         while (1) {
298                 struct pollfd fds[1];
299                 unsigned deadline_us;
300                 struct arp_packet p;
301                 int source_ip_conflict;
302                 int target_ip_conflict;
303
304                 fds[0].fd = sock_fd;
305                 fds[0].events = POLLIN;
306                 fds[0].revents = 0;
307
308                 // poll, being ready to adjust current timeout
309                 if (!timeout_ms) {
310                         timeout_ms = random_delay_ms(PROBE_WAIT);
311                         // FIXME setsockopt(sock_fd, SO_ATTACH_FILTER, ...) to
312                         // make the kernel filter out all packets except
313                         // ones we'd care about.
314                 }
315                 // set deadline_us to the point in time when we timeout
316                 deadline_us = MONOTONIC_US() + timeout_ms * 1000;
317
318                 VDBG("...wait %d %s nprobes=%u, nclaims=%u\n",
319                                 timeout_ms, intf, nprobes, nclaims);
320
321                 switch (safe_poll(fds, 1, timeout_ms)) {
322
323                 default:
324                         //bb_perror_msg("poll"); - done in safe_poll
325                         return EXIT_FAILURE;
326
327                 // timeout
328                 case 0:
329                         VDBG("state = %d\n", state);
330                         switch (state) {
331                         case PROBE:
332                                 // timeouts in the PROBE state mean no conflicting ARP packets
333                                 // have been received, so we can progress through the states
334                                 if (nprobes < PROBE_NUM) {
335                                         nprobes++;
336                                         VDBG("probe/%u %s@%s\n",
337                                                         nprobes, intf, inet_ntoa(ip));
338                                         arp(ARPOP_REQUEST,
339                                                         &eth_addr, null_ip,
340                                                         &null_addr, ip);
341                                         timeout_ms = PROBE_MIN * 1000;
342                                         timeout_ms += random_delay_ms(PROBE_MAX - PROBE_MIN);
343                                 }
344                                 else {
345                                         // Switch to announce state.
346                                         state = ANNOUNCE;
347                                         nclaims = 0;
348                                         VDBG("announce/%u %s@%s\n",
349                                                         nclaims, intf, inet_ntoa(ip));
350                                         arp(ARPOP_REQUEST,
351                                                         &eth_addr, ip,
352                                                         &eth_addr, ip);
353                                         timeout_ms = ANNOUNCE_INTERVAL * 1000;
354                                 }
355                                 break;
356                         case RATE_LIMIT_PROBE:
357                                 // timeouts in the RATE_LIMIT_PROBE state mean no conflicting ARP packets
358                                 // have been received, so we can move immediately to the announce state
359                                 state = ANNOUNCE;
360                                 nclaims = 0;
361                                 VDBG("announce/%u %s@%s\n",
362                                                 nclaims, intf, inet_ntoa(ip));
363                                 arp(ARPOP_REQUEST,
364                                                 &eth_addr, ip,
365                                                 &eth_addr, ip);
366                                 timeout_ms = ANNOUNCE_INTERVAL * 1000;
367                                 break;
368                         case ANNOUNCE:
369                                 // timeouts in the ANNOUNCE state mean no conflicting ARP packets
370                                 // have been received, so we can progress through the states
371                                 if (nclaims < ANNOUNCE_NUM) {
372                                         nclaims++;
373                                         VDBG("announce/%u %s@%s\n",
374                                                         nclaims, intf, inet_ntoa(ip));
375                                         arp(ARPOP_REQUEST,
376                                                         &eth_addr, ip,
377                                                         &eth_addr, ip);
378                                         timeout_ms = ANNOUNCE_INTERVAL * 1000;
379                                 }
380                                 else {
381                                         // Switch to monitor state.
382                                         state = MONITOR;
383                                         // link is ok to use earlier
384                                         // FIXME update filters
385                                         script_av[1] = (char*)"config";
386                                         run(script_av, &ip);
387                                         ready = 1;
388                                         conflicts = 0;
389                                         timeout_ms = -1; // Never timeout in the monitor state.
390
391                                         // NOTE: all other exit paths
392                                         // should deconfig ...
393                                         if (QUIT)
394                                                 return EXIT_SUCCESS;
395                                 }
396                                 break;
397                         case DEFEND:
398                                 // We won!  No ARP replies, so just go back to monitor.
399                                 state = MONITOR;
400                                 timeout_ms = -1;
401                                 conflicts = 0;
402                                 break;
403                         default:
404                                 // Invalid, should never happen.  Restart the whole protocol.
405                                 state = PROBE;
406                                 pick(&ip);
407                                 timeout_ms = 0;
408                                 nprobes = 0;
409                                 nclaims = 0;
410                                 break;
411                         } // switch (state)
412                         break; // case 0 (timeout)
413
414                 // packets arriving, or link went down
415                 case 1:
416                         // We need to adjust the timeout in case we didn't receive
417                         // a conflicting packet.
418                         if (timeout_ms > 0) {
419                                 unsigned diff = deadline_us - MONOTONIC_US();
420                                 if ((int)(diff) < 0) {
421                                         // Current time is greater than the expected timeout time.
422                                         // Should never happen.
423                                         VDBG("missed an expected timeout\n");
424                                         timeout_ms = 0;
425                                 } else {
426                                         VDBG("adjusting timeout\n");
427                                         timeout_ms = (diff / 1000) | 1; /* never 0 */
428                                 }
429                         }
430
431                         if ((fds[0].revents & POLLIN) == 0) {
432                                 if (fds[0].revents & POLLERR) {
433                                         // FIXME: links routinely go down;
434                                         // this shouldn't necessarily exit.
435                                         bb_error_msg("iface %s is down", intf);
436                                         if (ready) {
437                                                 script_av[1] = (char*)"deconfig";
438                                                 run(script_av, &ip);
439                                         }
440                                         return EXIT_FAILURE;
441                                 }
442                                 continue;
443                         }
444
445                         // read ARP packet
446                         if (safe_read(sock_fd, &p, sizeof(p)) < 0) {
447                                 bb_perror_msg_and_die(bb_msg_read_error);
448                         }
449                         if (p.eth.ether_type != htons(ETHERTYPE_ARP))
450                                 continue;
451 #ifdef DEBUG
452                         {
453                                 struct ether_addr *sha = (struct ether_addr *) p.arp.arp_sha;
454                                 struct ether_addr *tha = (struct ether_addr *) p.arp.arp_tha;
455                                 struct in_addr *spa = (struct in_addr *) p.arp.arp_spa;
456                                 struct in_addr *tpa = (struct in_addr *) p.arp.arp_tpa;
457                                 VDBG("%s recv arp type=%d, op=%d,\n",
458                                         intf, ntohs(p.eth.ether_type),
459                                         ntohs(p.arp.arp_op));
460                                 VDBG("\tsource=%s %s\n",
461                                         ether_ntoa(sha),
462                                         inet_ntoa(*spa));
463                                 VDBG("\ttarget=%s %s\n",
464                                         ether_ntoa(tha),
465                                         inet_ntoa(*tpa));
466                         }
467 #endif
468                         if (p.arp.arp_op != htons(ARPOP_REQUEST)
469                          && p.arp.arp_op != htons(ARPOP_REPLY))
470                                 continue;
471
472                         source_ip_conflict = 0;
473                         target_ip_conflict = 0;
474
475                         if (memcmp(p.arp.arp_spa, &ip.s_addr, sizeof(struct in_addr)) == 0
476                          && memcmp(&p.arp.arp_sha, &eth_addr, ETH_ALEN) != 0
477                         ) {
478                                 source_ip_conflict = 1;
479                         }
480                         if (p.arp.arp_op == htons(ARPOP_REQUEST)
481                          && memcmp(p.arp.arp_tpa, &ip.s_addr, sizeof(struct in_addr)) == 0
482                          && memcmp(&p.arp.arp_tha, &eth_addr, ETH_ALEN) != 0
483                         ) {
484                                 target_ip_conflict = 1;
485                         }
486
487                         VDBG("state = %d, source ip conflict = %d, target ip conflict = %d\n",
488                                 state, source_ip_conflict, target_ip_conflict);
489                         switch (state) {
490                         case PROBE:
491                         case ANNOUNCE:
492                                 // When probing or announcing, check for source IP conflicts
493                                 // and other hosts doing ARP probes (target IP conflicts).
494                                 if (source_ip_conflict || target_ip_conflict) {
495                                         conflicts++;
496                                         if (conflicts >= MAX_CONFLICTS) {
497                                                 VDBG("%s ratelimit\n", intf);
498                                                 timeout_ms = RATE_LIMIT_INTERVAL * 1000;
499                                                 state = RATE_LIMIT_PROBE;
500                                         }
501
502                                         // restart the whole protocol
503                                         pick(&ip);
504                                         timeout_ms = 0;
505                                         nprobes = 0;
506                                         nclaims = 0;
507                                 }
508                                 break;
509                         case MONITOR:
510                                 // If a conflict, we try to defend with a single ARP probe.
511                                 if (source_ip_conflict) {
512                                         VDBG("monitor conflict -- defending\n");
513                                         state = DEFEND;
514                                         timeout_ms = DEFEND_INTERVAL * 1000;
515                                         arp(ARPOP_REQUEST,
516                                                 &eth_addr, ip,
517                                                 &eth_addr, ip);
518                                 }
519                                 break;
520                         case DEFEND:
521                                 // Well, we tried.  Start over (on conflict).
522                                 if (source_ip_conflict) {
523                                         state = PROBE;
524                                         VDBG("defend conflict -- starting over\n");
525                                         ready = 0;
526                                         script_av[1] = (char*)"deconfig";
527                                         run(script_av, &ip);
528
529                                         // restart the whole protocol
530                                         pick(&ip);
531                                         timeout_ms = 0;
532                                         nprobes = 0;
533                                         nclaims = 0;
534                                 }
535                                 break;
536                         default:
537                                 // Invalid, should never happen.  Restart the whole protocol.
538                                 VDBG("invalid state -- starting over\n");
539                                 state = PROBE;
540                                 pick(&ip);
541                                 timeout_ms = 0;
542                                 nprobes = 0;
543                                 nclaims = 0;
544                                 break;
545                         } // switch state
546                         break; // case 1 (packets arriving)
547                 } // switch poll
548         } // while (1)
549 }