2 * arp This file contains an implementation of the command
3 * that maintains the kernel's ARP cache. It is derived
4 * from Berkeley UNIX arp(8), but cleaner and with sup-
5 * port for devices other than Ethernet.
7 * NET-TOOLS A collection of programs that form the base set of the
8 * NET-3 Networking Distribution for the LINUX operating
11 * Version: $Id: arp.c,v 1.19 2000/12/19 00:34:27 ecki Exp $
13 * Maintainer: Bernd 'eckes' Eckenfels, <net-tools@lina.inka.de>
15 * Author: Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
18 * (based on work from Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>)
19 * Alan Cox : modified for NET3
20 * Andrew Tridgell : proxy arp netmasks
21 * Bernd Eckenfels : -n option
22 * Bernd Eckenfels : Use only /proc for display
23 * {1.60} Bernd Eckenfels : new arpcode (-i) for 1.3.42 but works
25 * {1.61} Bernd Eckenfels : more verbose messages
26 * {1.62} Bernd Eckenfels : check -t for hw adresses and try to
27 * explain EINVAL (jeff)
28 *970125 {1.63} Bernd Eckenfels : -a print hardwarename instead of tiltle
29 *970201 {1.64} Bernd Eckenfels : net-features.h support
30 *970203 {1.65} Bernd Eckenfels : "#define" in "#if",
31 * -H|-A additional to -t|-p
32 *970214 {1.66} Bernd Eckenfels : Fix optarg required for -H and -A
33 *970412 {1.67} Bernd Eckenfels : device=""; is default
34 *970514 {1.68} Bernd Eckenfels : -N and -D
35 *970517 {1.69} Bernd Eckenfels : usage() fixed
36 *970622 {1.70} Bernd Eckenfels : arp -d priv
37 *970106 {1.80} Bernd Eckenfels : new syntax without -D and with "dev <If>",
38 * ATF_MAGIC, ATF_DONTPUB support.
39 * Typo fix (Debian Bug#5728 Giuliano Procida)
40 *970803 {1.81} Bernd Eckenfels : removed junk comment line 1
41 *970925 {1.82} Bernd Eckenfels : include fix for libc6
42 *980213 (1.83) Phil Blundell: set ATF_COM on new entries
43 *980629 (1.84) Arnaldo Carvalho de Melo: gettext instead of catgets
44 *990101 {1.85} Bernd Eckenfels fixed usage and return codes
45 *990105 (1.86) Phil Blundell: don't ignore EINVAL in arp_set
46 *991121 (1.87) Bernd Eckenfels: yes --device has a mandatory arg
48 * This program is free software; you can redistribute it
49 * and/or modify it under the terms of the GNU General
50 * Public License as published by the Free Software
51 * Foundation; either version 2 of the License, or (at
52 * your option) any later version.
54 #include <sys/types.h>
55 #include <sys/socket.h>
56 #include <sys/ioctl.h>
58 /* #include <linux/netdevice.h> */
59 /* #include <linux/if_arp.h> */
60 #include <net/if_arp.h>
69 #include "net-support.h"
70 #include "pathnames.h"
76 #define DFLT_AF "inet"
77 #define DFLT_HW "ether"
80 #include "lib/net-features.h"
82 char *Release = RELEASE, *Version = "arp 1.87 (1999-11-21)";
84 int opt_n = 0; /* do not resolve addresses */
85 int opt_N = 0; /* use symbolic names */
86 int opt_v = 0; /* debugging output flag */
87 int opt_D = 0; /* HW-address is devicename */
88 int opt_e = 0; /* 0=BSD output, 1=new linux */
89 int opt_a = 0; /* all entries, substring match */
90 struct aftype *ap; /* current address family */
91 struct hwtype *hw; /* current hardware type */
92 int sockfd = 0; /* active socket descriptor */
93 int hw_set = 0; /* flag if hw-type was set (-H) */
94 char device[16] = ""; /* current device */
95 static void usage(void);
97 /* Delete an entry from the ARP cache. */
98 static int arp_del(char **args)
106 memset((char *) &req, 0, sizeof(req));
108 /* Resolve the host name. */
110 fprintf(stderr, _("arp: need host name\n"));
113 safe_strncpy(host, *args, (sizeof host));
114 if (ap->input(0, host, &sa) < 0) {
118 /* If a host has more than one address, use the correct one! */
119 memcpy((char *) &req.arp_pa, (char *) &sa, sizeof(struct sockaddr));
122 req.arp_ha.sa_family = hw->type;
124 req.arp_flags = ATF_PERM;
126 while (*args != NULL) {
128 fprintf(stderr, "args=%s\n", *args);
129 if (!strcmp(*args, "pub")) {
134 if (!strcmp(*args, "priv")) {
139 if (!strcmp(*args, "temp")) {
140 req.arp_flags &= ~ATF_PERM;
144 if (!strcmp(*args, "trail")) {
145 req.arp_flags |= ATF_USETRAILERS;
149 if (!strcmp(*args, "dontpub")) {
150 #ifdef HAVE_ATF_DONTPUB
151 req.arp_flags |= ATF_DONTPUB;
153 ENOSUPP("arp", "ATF_DONTPUB");
158 if (!strcmp(*args, "auto")) {
159 #ifdef HAVE_ATF_MAGIC
160 req.arp_flags |= ATF_MAGIC;
162 ENOSUPP("arp", "ATF_MAGIC");
167 if (!strcmp(*args, "dev")) {
170 safe_strncpy(device, *args, sizeof(device));
174 if (!strcmp(*args, "netmask")) {
177 if (strcmp(*args, "255.255.255.255") != 0) {
179 if (ap->input(0, host, &sa) < 0) {
183 memcpy((char *) &req.arp_netmask, (char *) &sa,
184 sizeof(struct sockaddr));
185 req.arp_flags |= ATF_NETMASK;
195 strcpy(req.arp_dev, device);
199 /* Call the kernel. */
202 fprintf(stderr, "arp: SIOCDARP(nopub)\n");
203 if ((err = ioctl(sockfd, SIOCDARP, &req) < 0)) {
204 if (errno == ENXIO) {
207 printf(_("No ARP entry for %s\n"), host);
210 perror("SIOCDARP(priv)");
214 if ((flags & 1) && (err)) {
216 req.arp_flags |= ATF_PUBL;
218 fprintf(stderr, "arp: SIOCDARP(pub)\n");
219 if (ioctl(sockfd, SIOCDARP, &req) < 0) {
220 if (errno == ENXIO) {
221 printf(_("No ARP entry for %s\n"), host);
224 perror("SIOCDARP(pub)");
231 /* Get the hardware address to a specified interface name */
232 static int arp_getdevhw(char *ifname, struct sockaddr *sa, struct hwtype *hw)
237 strcpy(ifr.ifr_name, ifname);
238 if (ioctl(sockfd, SIOCGIFHWADDR, &ifr) < 0) {
239 fprintf(stderr, _("arp: cant get HW-Address for `%s': %s.\n"), ifname, strerror(errno));
242 if (hw && (ifr.ifr_hwaddr.sa_family != hw->type)) {
243 fprintf(stderr, _("arp: protocol type mismatch.\n"));
246 memcpy((char *) sa, (char *) &(ifr.ifr_hwaddr), sizeof(struct sockaddr));
249 if (!(xhw = get_hwntype(ifr.ifr_hwaddr.sa_family)) || (xhw->print == 0)) {
250 xhw = get_hwntype(-1);
252 fprintf(stderr, _("arp: device `%s' has HW address %s `%s'.\n"), ifname, xhw->name, xhw->print((char *)&ifr.ifr_hwaddr.sa_data));
257 /* Set an entry in the ARP cache. */
258 static int arp_set(char **args)
265 memset((char *) &req, 0, sizeof(req));
267 /* Resolve the host name. */
269 fprintf(stderr, _("arp: need host name\n"));
272 safe_strncpy(host, *args++, (sizeof host));
273 if (ap->input(0, host, &sa) < 0) {
277 /* If a host has more than one address, use the correct one! */
278 memcpy((char *) &req.arp_pa, (char *) &sa, sizeof(struct sockaddr));
280 /* Fetch the hardware address. */
282 fprintf(stderr, _("arp: need hardware address\n"));
286 if (arp_getdevhw(*args++, &req.arp_ha, hw_set ? hw : NULL) < 0)
289 if (hw->input(*args++, &req.arp_ha) < 0) {
290 fprintf(stderr, _("arp: invalid hardware address\n"));
295 /* Check out any modifiers. */
296 flags = ATF_PERM | ATF_COM;
297 while (*args != NULL) {
298 if (!strcmp(*args, "temp")) {
303 if (!strcmp(*args, "pub")) {
308 if (!strcmp(*args, "priv")) {
313 if (!strcmp(*args, "trail")) {
314 flags |= ATF_USETRAILERS;
318 if (!strcmp(*args, "dontpub")) {
319 #ifdef HAVE_ATF_DONTPUB
320 flags |= ATF_DONTPUB;
322 ENOSUPP("arp", "ATF_DONTPUB");
327 if (!strcmp(*args, "auto")) {
328 #ifdef HAVE_ATF_MAGIC
331 ENOSUPP("arp", "ATF_MAGIC");
336 if (!strcmp(*args, "dev")) {
339 safe_strncpy(device, *args, sizeof(device));
343 if (!strcmp(*args, "netmask")) {
346 if (strcmp(*args, "255.255.255.255") != 0) {
348 if (ap->input(0, host, &sa) < 0) {
352 memcpy((char *) &req.arp_netmask, (char *) &sa,
353 sizeof(struct sockaddr));
354 flags |= ATF_NETMASK;
362 /* Fill in the remainder of the request. */
363 req.arp_flags = flags;
365 strcpy(req.arp_dev, device);
367 /* Call the kernel. */
369 fprintf(stderr, "arp: SIOCSARP()\n");
370 if (ioctl(sockfd, SIOCSARP, &req) < 0) {
378 /* Process an EtherFile */
379 static int arp_file(char *name)
386 if ((fp = fopen(name, "r")) == NULL) {
387 fprintf(stderr, _("arp: cannot open etherfile %s !\n"), name);
390 /* Read the lines in the file. */
392 while (fgets(buff, sizeof(buff), fp) != (char *) NULL) {
395 fprintf(stderr, ">> %s", buff);
396 if ((sp = strchr(buff, '\n')) != (char *) NULL)
398 if (buff[0] == '#' || buff[0] == '\0')
401 argc = getargs(buff, args);
403 fprintf(stderr, _("arp: format error on line %u of etherfile %s !\n"),
407 if (strchr (args[0], ':') != NULL) {
408 /* We have a correct ethers file, switch hw adress and hostname
415 if (arp_set(args) != 0)
416 fprintf(stderr, _("arp: cannot set entry on line %u of etherfile %s !\n"),
425 /* Print the contents of an ARP request block. */
426 static void arp_disp_2(char *name, int type, int arp_flags, char *hwa, char *mask, char *dev)
428 static int title = 0;
432 xhw = get_hwntype(type);
434 xhw = get_hwtype(DFLT_HW);
437 printf(_("Address HWtype HWaddress Flags Mask Iface\n"));
439 /* Setup the flags. */
441 if (arp_flags & ATF_COM)
443 if (arp_flags & ATF_PERM)
445 if (arp_flags & ATF_PUBL)
447 #ifdef HAVE_ATF_MAGIC
448 if (arp_flags & ATF_MAGIC)
451 #ifdef HAVE_ATF_DONTPUB
452 if (arp_flags & ATF_DONTPUB)
455 if (arp_flags & ATF_USETRAILERS)
458 if (!(arp_flags & ATF_NETMASK))
461 printf("%-23.23s ", name);
463 if (!(arp_flags & ATF_COM)) {
464 if (arp_flags & ATF_PUBL)
465 printf("%-8.8s%-20.20s", "*", "*");
467 printf("%-8.8s%-20.20s", "", _("(incomplete)"));
469 printf("%-8.8s%-20.20s", xhw->name, hwa);
472 printf("%-6.6s%-15.15s %s\n", flags, mask, dev);
475 /* Print the contents of an ARP request block. */
476 static void arp_disp(char *name, char *ip, int type, int arp_flags, char *hwa, char *mask, char *dev)
480 xhw = get_hwntype(type);
482 xhw = get_hwtype(DFLT_HW);
484 printf(_("%s (%s) at "), name, ip);
486 if (!(arp_flags & ATF_COM)) {
487 if (arp_flags & ATF_PUBL)
490 printf(_("<incomplete> "));
492 printf("%s [%s] ", hwa, xhw->name);
495 if (arp_flags & ATF_NETMASK)
496 printf(_("netmask %s "), mask);
498 if (arp_flags & ATF_PERM)
500 if (arp_flags & ATF_PUBL)
502 #ifdef HAVE_ATF_MAGIC
503 if (arp_flags & ATF_MAGIC)
506 #ifdef HAVE_ATF_DONTPUB
507 if (arp_flags & ATF_DONTPUB)
510 if (arp_flags & ATF_USETRAILERS)
513 printf(_("on %s\n"), dev);
517 /* Display the contents of the ARP cache in the kernel. */
518 static int arp_show(char *name)
530 int num, entries = 0, showed = 0;
535 /* Resolve the host name. */
536 safe_strncpy(host, name, (sizeof host));
537 if (ap->input(0, host, &sa) < 0) {
541 safe_strncpy(host, ap->sprint(&sa, 1), sizeof(host));
543 /* Open the PROCps kernel table. */
544 if ((fp = fopen(_PATH_PROCNET_ARP, "r")) == NULL) {
545 perror(_PATH_PROCNET_ARP);
548 /* Bypass header -- read until newline */
549 if (fgets(line, sizeof(line), fp) != (char *) NULL) {
552 /* Read the ARP cache entries. */
553 for (; fgets(line, sizeof(line), fp);) {
554 num = sscanf(line, "%s 0x%x 0x%x %100s %100s %100s\n",
555 ip, &type, &flags, hwa, mask, dev);
560 /* if the user specified hw-type differs, skip it */
561 if (hw_set && (type != hw->type))
564 /* if the user specified address differs, skip it */
565 if (host[0] && strcmp(ip, host))
568 /* if the user specified device differs, skip it */
569 if (device[0] && strcmp(dev, device))
573 /* This IS ugly but it works -be */
577 if (ap->input(0, ip, &sa) < 0)
580 hostname = ap->sprint(&sa, opt_n | 0x8000);
581 if (strcmp(hostname, ip) == 0)
586 arp_disp_2(hostname[0] == '?' ? ip : hostname, type, flags, hwa, mask, dev);
588 arp_disp(hostname, ip, type, flags, hwa, mask, dev);
592 printf(_("Entries: %d\tSkipped: %d\tFound: %d\n"), entries, entries - showed, showed);
595 if (host[0] && !opt_a)
596 printf(_("%s (%s) -- no entry\n"), name, host);
597 else if (hw_set || host[0] || device[0]) {
598 printf(_("arp: in %d entries no match found.\n"), entries);
605 static void version(void)
607 fprintf(stderr, "%s\n%s\n%s\n", Release, Version, Features);
611 static void usage(void)
613 fprintf(stderr, _("Usage:\n arp [-vn] [<HW>] [-i <if>] [-a] [<hostname>] <-Display ARP cache\n"));
614 fprintf(stderr, _(" arp [-v] [-i <if>] -d <hostname> [pub][nopub] <-Delete ARP entry\n"));
615 fprintf(stderr, _(" arp [-vnD] [<HW>] [-i <if>] -f [<filename>] <-Add entry from file\n"));
616 fprintf(stderr, _(" arp [-v] [<HW>] [-i <if>] -s <hostname> <hwaddr> [temp][nopub] <-Add entry\n"));
617 fprintf(stderr, _(" arp [-v] [<HW>] [-i <if>] -s <hostname> <hwaddr> [netmask <nm>] pub <-''-\n"));
618 fprintf(stderr, _(" arp [-v] [<HW>] [-i <if>] -Ds <hostname> <if> [netmask <nm>] pub <-''-\n\n"));
620 fprintf(stderr, _(" -a display (all) hosts in alternative (BSD) style\n"));
621 fprintf(stderr, _(" -s, --set set a new ARP entry\n"));
622 fprintf(stderr, _(" -d, --delete delete a specified entry\n"));
623 fprintf(stderr, _(" -v, --verbose be verbose\n"));
624 fprintf(stderr, _(" -n, --numeric don't resolve names\n"));
625 fprintf(stderr, _(" -i, --device specify network interface (e.g. eth0)\n"));
626 fprintf(stderr, _(" -D, --use-device read <hwaddr> from given device\n"));
627 fprintf(stderr, _(" -A, -p, --protocol specify protocol family\n"));
628 fprintf(stderr, _(" -f, --file read new entries from file or from /etc/ethers\n\n"));
630 fprintf(stderr, _(" <HW>=Use '-H <hw>' to specify hardware address type. Default: %s\n"), DFLT_HW);
631 fprintf(stderr, _(" List of possible hardware types (which support ARP):\n"));
632 print_hwlist(1); /* 1 = ARPable */
636 int main(int argc, char **argv)
639 struct option longopts[] =
641 {"verbose", 0, 0, 'v'},
642 {"version", 0, 0, 'V'},
644 {"delete", 0, 0, 'd'},
646 {"numeric", 0, 0, 'n'},
648 {"protocol", 1, 0, 'A'},
649 {"hw-type", 1, 0, 'H'},
650 {"device", 1, 0, 'i'},
652 {"use-device", 0, 0, 'D'},
653 {"symbolic", 0, 0, 'N'},
658 bindtextdomain("net-tools", "/usr/share/locale");
659 textdomain("net-tools");
662 /* Initialize variables... */
663 if ((hw = get_hwtype(DFLT_HW)) == NULL) {
664 fprintf(stderr, _("%s: hardware type not supported!\n"), DFLT_HW);
667 if ((ap = get_aftype(DFLT_AF)) == NULL) {
668 fprintf(stderr, _("%s: address family not supported!\n"), DFLT_AF);
673 /* Fetch the command-line arguments. */
675 while ((i = getopt_long(argc, argv, "A:H:adfp:nsei:t:vh?DNV", longopts, &lop)) != EOF)
703 fprintf(stderr, _("arp: -N not yet supported.\n"));
711 ap = get_aftype(optarg);
713 fprintf(stderr, _("arp: %s: unknown address family.\n"),
720 hw = get_hwtype(optarg);
722 fprintf(stderr, _("arp: %s: unknown hardware type.\n"),
729 safe_strncpy(device, optarg, sizeof(device));
740 if (ap->af != AF_INET) {
741 fprintf(stderr, _("arp: %s: kernel only supports 'inet'.\n"),
746 /* If not hw type specified get default */
748 if ((hw = get_hwtype(DFLT_HW)) == NULL) {
749 fprintf(stderr, _("%s: hardware type not supported!\n"), DFLT_HW);
754 fprintf(stderr, _("arp: %s: hardware type without ARP support.\n"),
758 if ((sockfd = socket(AF_INET, SOCK_DGRAM, 0)) < 0) {
762 /* Now see what we have to do here... */
766 what = arp_show(argv[optind]);
769 case 1: /* show an ARP entry in the cache */
770 what = arp_show(argv[optind]);
773 case 2: /* process an EtherFile */
774 what = arp_file(argv[optind] ? argv[optind] : "/etc/ethers");
777 case 3: /* delete an ARP entry from the cache */
778 what = arp_del(&argv[optind]);
781 case 4: /* set an ARP entry in the cache */
782 what = arp_set(&argv[optind]);