About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / networking / ifenslave.c




Custom Search

Based on kernel version 3.10. Page generated on 2013-07-08 20:16 EST.

1	/* Mode: C;
2	 * ifenslave.c: Configure network interfaces for parallel routing.
3	 *
4	 *	This program controls the Linux implementation of running multiple
5	 *	network interfaces in parallel.
6	 *
7	 * Author:	Donald Becker <becker@cesdis.gsfc.nasa.gov>
8	 *		Copyright 1994-1996 Donald Becker
9	 *
10	 *		This program is free software; you can redistribute it
11	 *		and/or modify it under the terms of the GNU General Public
12	 *		License as published by the Free Software Foundation.
13	 *
14	 *	The author may be reached as becker@CESDIS.gsfc.nasa.gov, or C/O
15	 *	Center of Excellence in Space Data and Information Sciences
16	 *	   Code 930.5, Goddard Space Flight Center, Greenbelt MD 20771
17	 *
18	 *  Changes :
19	 *    - 2000/10/02 Willy Tarreau <willy at meta-x.org> :
20	 *       - few fixes. Master's MAC address is now correctly taken from
21	 *         the first device when not previously set ;
22	 *       - detach support : call BOND_RELEASE to detach an enslaved interface.
23	 *       - give a mini-howto from command-line help : # ifenslave -h
24	 *
25	 *    - 2001/02/16 Chad N. Tindel <ctindel at ieee dot org> :
26	 *       - Master is now brought down before setting the MAC address.  In
27	 *         the 2.4 kernel you can't change the MAC address while the device is
28	 *         up because you get EBUSY.
29	 *
30	 *    - 2001/09/13 Takao Indoh <indou dot takao at jp dot fujitsu dot com>
31	 *       - Added the ability to change the active interface on a mode 1 bond
32	 *         at runtime.
33	 *
34	 *    - 2001/10/23 Chad N. Tindel <ctindel at ieee dot org> :
35	 *       - No longer set the MAC address of the master.  The bond device will
36	 *         take care of this itself
37	 *       - Try the SIOC*** versions of the bonding ioctls before using the
38	 *         old versions
39	 *    - 2002/02/18 Erik Habbinga <erik_habbinga @ hp dot com> :
40	 *       - ifr2.ifr_flags was not initialized in the hwaddr_notset case,
41	 *         SIOCGIFFLAGS now called before hwaddr_notset test
42	 *
43	 *    - 2002/10/31 Tony Cureington <tony.cureington * hp_com> :
44	 *       - If the master does not have a hardware address when the first slave
45	 *         is enslaved, the master is assigned the hardware address of that
46	 *         slave - there is a comment in bonding.c stating "ifenslave takes
47	 *         care of this now." This corrects the problem of slaves having
48	 *         different hardware addresses in active-backup mode when
49	 *         multiple interfaces are specified on a single ifenslave command
50	 *         (ifenslave bond0 eth0 eth1).
51	 *
52	 *    - 2003/03/18 - Tsippy Mendelson <tsippy.mendelson at intel dot com> and
53	 *                   Shmulik Hen <shmulik.hen at intel dot com>
54	 *       - Moved setting the slave's mac address and openning it, from
55	 *         the application to the driver. This enables support of modes
56	 *         that need to use the unique mac address of each slave.
57	 *         The driver also takes care of closing the slave and restoring its
58	 *         original mac address upon release.
59	 *         In addition, block possibility of enslaving before the master is up.
60	 *         This prevents putting the system in an undefined state.
61	 *
62	 *    - 2003/05/01 - Amir Noam <amir.noam at intel dot com>
63	 *       - Added ABI version control to restore compatibility between
64	 *         new/old ifenslave and new/old bonding.
65	 *       - Prevent adding an adapter that is already a slave.
66	 *         Fixes the problem of stalling the transmission and leaving
67	 *         the slave in a down state.
68	 *
69	 *    - 2003/05/01 - Shmulik Hen <shmulik.hen at intel dot com>
70	 *       - Prevent enslaving if the bond device is down.
71	 *         Fixes the problem of leaving the system in unstable state and
72	 *         halting when trying to remove the module.
73	 *       - Close socket on all abnormal exists.
74	 *       - Add versioning scheme that follows that of the bonding driver.
75	 *         current version is 1.0.0 as a base line.
76	 *
77	 *    - 2003/05/22 - Jay Vosburgh <fubar at us dot ibm dot com>
78	 *	 - ifenslave -c was broken; it's now fixed
79	 *	 - Fixed problem with routes vanishing from master during enslave
80	 *	   processing.
81	 *
82	 *    - 2003/05/27 - Amir Noam <amir.noam at intel dot com>
83	 *	 - Fix backward compatibility issues:
84	 *	   For drivers not using ABI versions, slave was set down while
85	 *	   it should be left up before enslaving.
86	 *	   Also, master was not set down and the default set_mac_address()
87	 *	   would fail and generate an error message in the system log.
88	 * 	 - For opt_c: slave should not be set to the master's setting
89	 *	   while it is running. It was already set during enslave. To
90	 *	   simplify things, it is now handled separately.
91	 *
92	 *    - 2003/12/01 - Shmulik Hen <shmulik.hen at intel dot com>
93	 *	 - Code cleanup and style changes
94	 *	   set version to 1.1.0
95	 */
96	
97	#define APP_VERSION	"1.1.0"
98	#define APP_RELDATE	"December 1, 2003"
99	#define APP_NAME	"ifenslave"
100	
101	static char *version =
102	APP_NAME ".c:v" APP_VERSION " (" APP_RELDATE ")\n"
103	"o Donald Becker (becker@cesdis.gsfc.nasa.gov).\n"
104	"o Detach support added on 2000/10/02 by Willy Tarreau (willy at meta-x.org).\n"
105	"o 2.4 kernel support added on 2001/02/16 by Chad N. Tindel\n"
106	"  (ctindel at ieee dot org).\n";
107	
108	static const char *usage_msg =
109	"Usage: ifenslave [-f] <master-if> <slave-if> [<slave-if>...]\n"
110	"       ifenslave -d   <master-if> <slave-if> [<slave-if>...]\n"
111	"       ifenslave -c   <master-if> <slave-if>\n"
112	"       ifenslave --help\n";
113	
114	static const char *help_msg =
115	"\n"
116	"       To create a bond device, simply follow these three steps :\n"
117	"       - ensure that the required drivers are properly loaded :\n"
118	"         # modprobe bonding ; modprobe <3c59x|eepro100|pcnet32|tulip|...>\n"
119	"       - assign an IP address to the bond device :\n"
120	"         # ifconfig bond0 <addr> netmask <mask> broadcast <bcast>\n"
121	"       - attach all the interfaces you need to the bond device :\n"
122	"         # ifenslave [{-f|--force}] bond0 eth0 [eth1 [eth2]...]\n"
123	"         If bond0 didn't have a MAC address, it will take eth0's. Then, all\n"
124	"         interfaces attached AFTER this assignment will get the same MAC addr.\n"
125	"         (except for ALB/TLB modes)\n"
126	"\n"
127	"       To set the bond device down and automatically release all the slaves :\n"
128	"         # ifconfig bond0 down\n"
129	"\n"
130	"       To detach a dead interface without setting the bond device down :\n"
131	"         # ifenslave {-d|--detach} bond0 eth0 [eth1 [eth2]...]\n"
132	"\n"
133	"       To change active slave :\n"
134	"         # ifenslave {-c|--change-active} bond0 eth0\n"
135	"\n"
136	"       To show master interface info\n"
137	"         # ifenslave bond0\n"
138	"\n"
139	"       To show all interfaces info\n"
140	"       # ifenslave {-a|--all-interfaces}\n"
141	"\n"
142	"       To be more verbose\n"
143	"       # ifenslave {-v|--verbose} ...\n"
144	"\n"
145	"       # ifenslave {-u|--usage}   Show usage\n"
146	"       # ifenslave {-V|--version} Show version\n"
147	"       # ifenslave {-h|--help}    This message\n"
148	"\n";
149	
150	#include <unistd.h>
151	#include <stdlib.h>
152	#include <stdio.h>
153	#include <ctype.h>
154	#include <string.h>
155	#include <errno.h>
156	#include <fcntl.h>
157	#include <getopt.h>
158	#include <sys/types.h>
159	#include <sys/socket.h>
160	#include <sys/ioctl.h>
161	#include <linux/if.h>
162	#include <net/if_arp.h>
163	#include <linux/if_ether.h>
164	#include <linux/if_bonding.h>
165	#include <linux/sockios.h>
166	
167	typedef unsigned long long u64;	/* hack, so we may include kernel's ethtool.h */
168	typedef __uint32_t u32;		/* ditto */
169	typedef __uint16_t u16;		/* ditto */
170	typedef __uint8_t u8;		/* ditto */
171	#include <linux/ethtool.h>
172	
173	struct option longopts[] = {
174		/* { name  has_arg  *flag  val } */
175		{"all-interfaces",	0, 0, 'a'},	/* Show all interfaces. */
176		{"change-active",	0, 0, 'c'},	/* Change the active slave.  */
177		{"detach",		0, 0, 'd'},	/* Detach a slave interface. */
178		{"force",		0, 0, 'f'},	/* Force the operation. */
179		{"help",		0, 0, 'h'},	/* Give help */
180		{"usage",		0, 0, 'u'},	/* Give usage */
181		{"verbose",		0, 0, 'v'},	/* Report each action taken. */
182		{"version",		0, 0, 'V'},	/* Emit version information. */
183		{ 0, 0, 0, 0}
184	};
185	
186	/* Command-line flags. */
187	unsigned int
188	opt_a = 0,	/* Show-all-interfaces flag. */
189	opt_c = 0,	/* Change-active-slave flag. */
190	opt_d = 0,	/* Detach a slave interface. */
191	opt_f = 0,	/* Force the operation. */
192	opt_h = 0,	/* Help */
193	opt_u = 0,	/* Usage */
194	opt_v = 0,	/* Verbose flag. */
195	opt_V = 0;	/* Version */
196	
197	int skfd = -1;		/* AF_INET socket for ioctl() calls.*/
198	int abi_ver = 0;	/* userland - kernel ABI version */
199	int hwaddr_set = 0;	/* Master's hwaddr is set */
200	int saved_errno;
201	
202	struct ifreq master_mtu, master_flags, master_hwaddr;
203	struct ifreq slave_mtu, slave_flags, slave_hwaddr;
204	
205	struct dev_ifr {
206		struct ifreq *req_ifr;
207		char *req_name;
208		int req_type;
209	};
210	
211	struct dev_ifr master_ifra[] = {
212		{&master_mtu,     "SIOCGIFMTU",     SIOCGIFMTU},
213		{&master_flags,   "SIOCGIFFLAGS",   SIOCGIFFLAGS},
214		{&master_hwaddr,  "SIOCGIFHWADDR",  SIOCGIFHWADDR},
215		{NULL, "", 0}
216	};
217	
218	struct dev_ifr slave_ifra[] = {
219		{&slave_mtu,     "SIOCGIFMTU",     SIOCGIFMTU},
220		{&slave_flags,   "SIOCGIFFLAGS",   SIOCGIFFLAGS},
221		{&slave_hwaddr,  "SIOCGIFHWADDR",  SIOCGIFHWADDR},
222		{NULL, "", 0}
223	};
224	
225	static void if_print(char *ifname);
226	static int get_drv_info(char *master_ifname);
227	static int get_if_settings(char *ifname, struct dev_ifr ifra[]);
228	static int get_slave_flags(char *slave_ifname);
229	static int set_master_hwaddr(char *master_ifname, struct sockaddr *hwaddr);
230	static int set_slave_hwaddr(char *slave_ifname, struct sockaddr *hwaddr);
231	static int set_slave_mtu(char *slave_ifname, int mtu);
232	static int set_if_flags(char *ifname, short flags);
233	static int set_if_up(char *ifname, short flags);
234	static int set_if_down(char *ifname, short flags);
235	static int clear_if_addr(char *ifname);
236	static int set_if_addr(char *master_ifname, char *slave_ifname);
237	static int change_active(char *master_ifname, char *slave_ifname);
238	static int enslave(char *master_ifname, char *slave_ifname);
239	static int release(char *master_ifname, char *slave_ifname);
240	#define v_print(fmt, args...)	\
241		if (opt_v)		\
242			fprintf(stderr, fmt, ## args )
243	
244	int main(int argc, char *argv[])
245	{
246		char **spp, *master_ifname, *slave_ifname;
247		int c, i, rv;
248		int res = 0;
249		int exclusive = 0;
250	
251		while ((c = getopt_long(argc, argv, "acdfhuvV", longopts, 0)) != EOF) {
252			switch (c) {
253			case 'a': opt_a++; exclusive++; break;
254			case 'c': opt_c++; exclusive++; break;
255			case 'd': opt_d++; exclusive++; break;
256			case 'f': opt_f++; exclusive++; break;
257			case 'h': opt_h++; exclusive++; break;
258			case 'u': opt_u++; exclusive++; break;
259			case 'v': opt_v++; break;
260			case 'V': opt_V++; exclusive++; break;
261	
262			case '?':
263				fprintf(stderr, "%s", usage_msg);
264				res = 2;
265				goto out;
266			}
267		}
268	
269		/* options check */
270		if (exclusive > 1) {
271			fprintf(stderr, "%s", usage_msg);
272			res = 2;
273			goto out;
274		}
275	
276		if (opt_v || opt_V) {
277			printf("%s", version);
278			if (opt_V) {
279				res = 0;
280				goto out;
281			}
282		}
283	
284		if (opt_u) {
285			printf("%s", usage_msg);
286			res = 0;
287			goto out;
288		}
289	
290		if (opt_h) {
291			printf("%s", usage_msg);
292			printf("%s", help_msg);
293			res = 0;
294			goto out;
295		}
296	
297		/* Open a basic socket */
298		if ((skfd = socket(AF_INET, SOCK_DGRAM, 0)) < 0) {
299			perror("socket");
300			res = 1;
301			goto out;
302		}
303	
304		if (opt_a) {
305			if (optind == argc) {
306				/* No remaining args */
307				/* show all interfaces */
308				if_print((char *)NULL);
309				goto out;
310			} else {
311				/* Just show usage */
312				fprintf(stderr, "%s", usage_msg);
313				res = 2;
314				goto out;
315			}
316		}
317	
318		/* Copy the interface name */
319		spp = argv + optind;
320		master_ifname = *spp++;
321	
322		if (master_ifname == NULL) {
323			fprintf(stderr, "%s", usage_msg);
324			res = 2;
325			goto out;
326		}
327	
328		/* exchange abi version with bonding module */
329		res = get_drv_info(master_ifname);
330		if (res) {
331			fprintf(stderr,
332				"Master '%s': Error: handshake with driver failed. "
333				"Aborting\n",
334				master_ifname);
335			goto out;
336		}
337	
338		slave_ifname = *spp++;
339	
340		if (slave_ifname == NULL) {
341			if (opt_d || opt_c) {
342				fprintf(stderr, "%s", usage_msg);
343				res = 2;
344				goto out;
345			}
346	
347			/* A single arg means show the
348			 * configuration for this interface
349			 */
350			if_print(master_ifname);
351			goto out;
352		}
353	
354		res = get_if_settings(master_ifname, master_ifra);
355		if (res) {
356			/* Probably a good reason not to go on */
357			fprintf(stderr,
358				"Master '%s': Error: get settings failed: %s. "
359				"Aborting\n",
360				master_ifname, strerror(res));
361			goto out;
362		}
363	
364		/* check if master is indeed a master;
365		 * if not then fail any operation
366		 */
367		if (!(master_flags.ifr_flags & IFF_MASTER)) {
368			fprintf(stderr,
369				"Illegal operation; the specified interface '%s' "
370				"is not a master. Aborting\n",
371				master_ifname);
372			res = 1;
373			goto out;
374		}
375	
376		/* check if master is up; if not then fail any operation */
377		if (!(master_flags.ifr_flags & IFF_UP)) {
378			fprintf(stderr,
379				"Illegal operation; the specified master interface "
380				"'%s' is not up.\n",
381				master_ifname);
382			res = 1;
383			goto out;
384		}
385	
386		/* Only for enslaving */
387		if (!opt_c && !opt_d) {
388			sa_family_t master_family = master_hwaddr.ifr_hwaddr.sa_family;
389			unsigned char *hwaddr =
390				(unsigned char *)master_hwaddr.ifr_hwaddr.sa_data;
391	
392			/* The family '1' is ARPHRD_ETHER for ethernet. */
393			if (master_family != 1 && !opt_f) {
394				fprintf(stderr,
395					"Illegal operation: The specified master "
396					"interface '%s' is not ethernet-like.\n "
397					"This program is designed to work with "
398					"ethernet-like network interfaces.\n "
399					"Use the '-f' option to force the "
400					"operation.\n",
401					master_ifname);
402				res = 1;
403				goto out;
404			}
405	
406			/* Check master's hw addr */
407			for (i = 0; i < 6; i++) {
408				if (hwaddr[i] != 0) {
409					hwaddr_set = 1;
410					break;
411				}
412			}
413	
414			if (hwaddr_set) {
415				v_print("current hardware address of master '%s' "
416					"is %2.2x:%2.2x:%2.2x:%2.2x:%2.2x:%2.2x, "
417					"type %d\n",
418					master_ifname,
419					hwaddr[0], hwaddr[1],
420					hwaddr[2], hwaddr[3],
421					hwaddr[4], hwaddr[5],
422					master_family);
423			}
424		}
425	
426		/* Accepts only one slave */
427		if (opt_c) {
428			/* change active slave */
429			res = get_slave_flags(slave_ifname);
430			if (res) {
431				fprintf(stderr,
432					"Slave '%s': Error: get flags failed. "
433					"Aborting\n",
434					slave_ifname);
435				goto out;
436			}
437			res = change_active(master_ifname, slave_ifname);
438			if (res) {
439				fprintf(stderr,
440					"Master '%s', Slave '%s': Error: "
441					"Change active failed\n",
442					master_ifname, slave_ifname);
443			}
444		} else {
445			/* Accept multiple slaves */
446			do {
447				if (opt_d) {
448					/* detach a slave interface from the master */
449					rv = get_slave_flags(slave_ifname);
450					if (rv) {
451						/* Can't work with this slave. */
452						/* remember the error and skip it*/
453						fprintf(stderr,
454							"Slave '%s': Error: get flags "
455							"failed. Skipping\n",
456							slave_ifname);
457						res = rv;
458						continue;
459					}
460					rv = release(master_ifname, slave_ifname);
461					if (rv) {
462						fprintf(stderr,
463							"Master '%s', Slave '%s': Error: "
464							"Release failed\n",
465							master_ifname, slave_ifname);
466						res = rv;
467					}
468				} else {
469					/* attach a slave interface to the master */
470					rv = get_if_settings(slave_ifname, slave_ifra);
471					if (rv) {
472						/* Can't work with this slave. */
473						/* remember the error and skip it*/
474						fprintf(stderr,
475							"Slave '%s': Error: get "
476							"settings failed: %s. "
477							"Skipping\n",
478							slave_ifname, strerror(rv));
479						res = rv;
480						continue;
481					}
482					rv = enslave(master_ifname, slave_ifname);
483					if (rv) {
484						fprintf(stderr,
485							"Master '%s', Slave '%s': Error: "
486							"Enslave failed\n",
487							master_ifname, slave_ifname);
488						res = rv;
489					}
490				}
491			} while ((slave_ifname = *spp++) != NULL);
492		}
493	
494	out:
495		if (skfd >= 0) {
496			close(skfd);
497		}
498	
499		return res;
500	}
501	
502	static short mif_flags;
503	
504	/* Get the inteface configuration from the kernel. */
505	static int if_getconfig(char *ifname)
506	{
507		struct ifreq ifr;
508		int metric, mtu;	/* Parameters of the master interface. */
509		struct sockaddr dstaddr, broadaddr, netmask;
510		unsigned char *hwaddr;
511	
512		strcpy(ifr.ifr_name, ifname);
513		if (ioctl(skfd, SIOCGIFFLAGS, &ifr) < 0)
514			return -1;
515		mif_flags = ifr.ifr_flags;
516		printf("The result of SIOCGIFFLAGS on %s is %x.\n",
517		       ifname, ifr.ifr_flags);
518	
519		strcpy(ifr.ifr_name, ifname);
520		if (ioctl(skfd, SIOCGIFADDR, &ifr) < 0)
521			return -1;
522		printf("The result of SIOCGIFADDR is %2.2x.%2.2x.%2.2x.%2.2x.\n",
523		       ifr.ifr_addr.sa_data[0], ifr.ifr_addr.sa_data[1],
524		       ifr.ifr_addr.sa_data[2], ifr.ifr_addr.sa_data[3]);
525	
526		strcpy(ifr.ifr_name, ifname);
527		if (ioctl(skfd, SIOCGIFHWADDR, &ifr) < 0)
528			return -1;
529	
530		/* Gotta convert from 'char' to unsigned for printf(). */
531		hwaddr = (unsigned char *)ifr.ifr_hwaddr.sa_data;
532		printf("The result of SIOCGIFHWADDR is type %d  "
533		       "%2.2x:%2.2x:%2.2x:%2.2x:%2.2x:%2.2x.\n",
534		       ifr.ifr_hwaddr.sa_family, hwaddr[0], hwaddr[1],
535		       hwaddr[2], hwaddr[3], hwaddr[4], hwaddr[5]);
536	
537		strcpy(ifr.ifr_name, ifname);
538		if (ioctl(skfd, SIOCGIFMETRIC, &ifr) < 0) {
539			metric = 0;
540		} else
541			metric = ifr.ifr_metric;
542		printf("The result of SIOCGIFMETRIC is %d\n", metric);
543	
544		strcpy(ifr.ifr_name, ifname);
545		if (ioctl(skfd, SIOCGIFMTU, &ifr) < 0)
546			mtu = 0;
547		else
548			mtu = ifr.ifr_mtu;
549		printf("The result of SIOCGIFMTU is %d\n", mtu);
550	
551		strcpy(ifr.ifr_name, ifname);
552		if (ioctl(skfd, SIOCGIFDSTADDR, &ifr) < 0) {
553			memset(&dstaddr, 0, sizeof(struct sockaddr));
554		} else
555			dstaddr = ifr.ifr_dstaddr;
556	
557		strcpy(ifr.ifr_name, ifname);
558		if (ioctl(skfd, SIOCGIFBRDADDR, &ifr) < 0) {
559			memset(&broadaddr, 0, sizeof(struct sockaddr));
560		} else
561			broadaddr = ifr.ifr_broadaddr;
562	
563		strcpy(ifr.ifr_name, ifname);
564		if (ioctl(skfd, SIOCGIFNETMASK, &ifr) < 0) {
565			memset(&netmask, 0, sizeof(struct sockaddr));
566		} else
567			netmask = ifr.ifr_netmask;
568	
569		return 0;
570	}
571	
572	static void if_print(char *ifname)
573	{
574		char buff[1024];
575		struct ifconf ifc;
576		struct ifreq *ifr;
577		int i;
578	
579		if (ifname == (char *)NULL) {
580			ifc.ifc_len = sizeof(buff);
581			ifc.ifc_buf = buff;
582			if (ioctl(skfd, SIOCGIFCONF, &ifc) < 0) {
583				perror("SIOCGIFCONF failed");
584				return;
585			}
586	
587			ifr = ifc.ifc_req;
588			for (i = ifc.ifc_len / sizeof(struct ifreq); --i >= 0; ifr++) {
589				if (if_getconfig(ifr->ifr_name) < 0) {
590					fprintf(stderr,
591						"%s: unknown interface.\n",
592						ifr->ifr_name);
593					continue;
594				}
595	
596				if (((mif_flags & IFF_UP) == 0) && !opt_a) continue;
597				/*ife_print(&ife);*/
598			}
599		} else {
600			if (if_getconfig(ifname) < 0) {
601				fprintf(stderr,
602					"%s: unknown interface.\n", ifname);
603			}
604		}
605	}
606	
607	static int get_drv_info(char *master_ifname)
608	{
609		struct ifreq ifr;
610		struct ethtool_drvinfo info;
611		char *endptr;
612	
613		memset(&ifr, 0, sizeof(ifr));
614		strncpy(ifr.ifr_name, master_ifname, IFNAMSIZ);
615		ifr.ifr_data = (caddr_t)&info;
616	
617		info.cmd = ETHTOOL_GDRVINFO;
618		strncpy(info.driver, "ifenslave", 32);
619		snprintf(info.fw_version, 32, "%d", BOND_ABI_VERSION);
620	
621		if (ioctl(skfd, SIOCETHTOOL, &ifr) < 0) {
622			if (errno == EOPNOTSUPP) {
623				goto out;
624			}
625	
626			saved_errno = errno;
627			v_print("Master '%s': Error: get bonding info failed %s\n",
628				master_ifname, strerror(saved_errno));
629			return 1;
630		}
631	
632		abi_ver = strtoul(info.fw_version, &endptr, 0);
633		if (*endptr) {
634	                v_print("Master '%s': Error: got invalid string as an ABI "
635				"version from the bonding module\n",
636				master_ifname);
637			return 1;
638		}
639	
640	out:
641		v_print("ABI ver is %d\n", abi_ver);
642	
643		return 0;
644	}
645	
646	static int change_active(char *master_ifname, char *slave_ifname)
647	{
648		struct ifreq ifr;
649		int res = 0;
650	
651		if (!(slave_flags.ifr_flags & IFF_SLAVE)) {
652			fprintf(stderr,
653				"Illegal operation: The specified slave interface "
654				"'%s' is not a slave\n",
655				slave_ifname);
656			return 1;
657		}
658	
659		strncpy(ifr.ifr_name, master_ifname, IFNAMSIZ);
660		strncpy(ifr.ifr_slave, slave_ifname, IFNAMSIZ);
661		if ((ioctl(skfd, SIOCBONDCHANGEACTIVE, &ifr) < 0) &&
662		    (ioctl(skfd, BOND_CHANGE_ACTIVE_OLD, &ifr) < 0)) {
663			saved_errno = errno;
664			v_print("Master '%s': Error: SIOCBONDCHANGEACTIVE failed: "
665				"%s\n",
666				master_ifname, strerror(saved_errno));
667			res = 1;
668		}
669	
670		return res;
671	}
672	
673	static int enslave(char *master_ifname, char *slave_ifname)
674	{
675		struct ifreq ifr;
676		int res = 0;
677	
678		if (slave_flags.ifr_flags & IFF_SLAVE) {
679			fprintf(stderr,
680				"Illegal operation: The specified slave interface "
681				"'%s' is already a slave\n",
682				slave_ifname);
683			return 1;
684		}
685	
686		res = set_if_down(slave_ifname, slave_flags.ifr_flags);
687		if (res) {
688			fprintf(stderr,
689				"Slave '%s': Error: bring interface down failed\n",
690				slave_ifname);
691			return res;
692		}
693	
694		if (abi_ver < 2) {
695			/* Older bonding versions would panic if the slave has no IP
696			 * address, so get the IP setting from the master.
697			 */
698			set_if_addr(master_ifname, slave_ifname);
699		} else {
700			res = clear_if_addr(slave_ifname);
701			if (res) {
702				fprintf(stderr,
703					"Slave '%s': Error: clear address failed\n",
704					slave_ifname);
705				return res;
706			}
707		}
708	
709		if (master_mtu.ifr_mtu != slave_mtu.ifr_mtu) {
710			res = set_slave_mtu(slave_ifname, master_mtu.ifr_mtu);
711			if (res) {
712				fprintf(stderr,
713					"Slave '%s': Error: set MTU failed\n",
714					slave_ifname);
715				return res;
716			}
717		}
718	
719		if (hwaddr_set) {
720			/* Master already has an hwaddr
721			 * so set it's hwaddr to the slave
722			 */
723			if (abi_ver < 1) {
724				/* The driver is using an old ABI, so
725				 * the application sets the slave's
726				 * hwaddr
727				 */
728				res = set_slave_hwaddr(slave_ifname,
729						       &(master_hwaddr.ifr_hwaddr));
730				if (res) {
731					fprintf(stderr,
732						"Slave '%s': Error: set hw address "
733						"failed\n",
734						slave_ifname);
735					goto undo_mtu;
736				}
737	
738				/* For old ABI the application needs to bring the
739				 * slave back up
740				 */
741				res = set_if_up(slave_ifname, slave_flags.ifr_flags);
742				if (res) {
743					fprintf(stderr,
744						"Slave '%s': Error: bring interface "
745						"down failed\n",
746						slave_ifname);
747					goto undo_slave_mac;
748				}
749			}
750			/* The driver is using a new ABI,
751			 * so the driver takes care of setting
752			 * the slave's hwaddr and bringing
753			 * it up again
754			 */
755		} else {
756			/* No hwaddr for master yet, so
757			 * set the slave's hwaddr to it
758			 */
759			if (abi_ver < 1) {
760				/* For old ABI, the master needs to be
761				 * down before setting its hwaddr
762				 */
763				res = set_if_down(master_ifname, master_flags.ifr_flags);
764				if (res) {
765					fprintf(stderr,
766						"Master '%s': Error: bring interface "
767						"down failed\n",
768						master_ifname);
769					goto undo_mtu;
770				}
771			}
772	
773			res = set_master_hwaddr(master_ifname,
774						&(slave_hwaddr.ifr_hwaddr));
775			if (res) {
776				fprintf(stderr,
777					"Master '%s': Error: set hw address "
778					"failed\n",
779					master_ifname);
780				goto undo_mtu;
781			}
782	
783			if (abi_ver < 1) {
784				/* For old ABI, bring the master
785				 * back up
786				 */
787				res = set_if_up(master_ifname, master_flags.ifr_flags);
788				if (res) {
789					fprintf(stderr,
790						"Master '%s': Error: bring interface "
791						"up failed\n",
792						master_ifname);
793					goto undo_master_mac;
794				}
795			}
796	
797			hwaddr_set = 1;
798		}
799	
800		/* Do the real thing */
801		strncpy(ifr.ifr_name, master_ifname, IFNAMSIZ);
802		strncpy(ifr.ifr_slave, slave_ifname, IFNAMSIZ);
803		if ((ioctl(skfd, SIOCBONDENSLAVE, &ifr) < 0) &&
804		    (ioctl(skfd, BOND_ENSLAVE_OLD, &ifr) < 0)) {
805			saved_errno = errno;
806			v_print("Master '%s': Error: SIOCBONDENSLAVE failed: %s\n",
807				master_ifname, strerror(saved_errno));
808			res = 1;
809		}
810	
811		if (res) {
812			goto undo_master_mac;
813		}
814	
815		return 0;
816	
817	/* rollback (best effort) */
818	undo_master_mac:
819		set_master_hwaddr(master_ifname, &(master_hwaddr.ifr_hwaddr));
820		hwaddr_set = 0;
821		goto undo_mtu;
822	undo_slave_mac:
823		set_slave_hwaddr(slave_ifname, &(slave_hwaddr.ifr_hwaddr));
824	undo_mtu:
825		set_slave_mtu(slave_ifname, slave_mtu.ifr_mtu);
826		return res;
827	}
828	
829	static int release(char *master_ifname, char *slave_ifname)
830	{
831		struct ifreq ifr;
832		int res = 0;
833	
834		if (!(slave_flags.ifr_flags & IFF_SLAVE)) {
835			fprintf(stderr,
836				"Illegal operation: The specified slave interface "
837				"'%s' is not a slave\n",
838				slave_ifname);
839			return 1;
840		}
841	
842		strncpy(ifr.ifr_name, master_ifname, IFNAMSIZ);
843		strncpy(ifr.ifr_slave, slave_ifname, IFNAMSIZ);
844		if ((ioctl(skfd, SIOCBONDRELEASE, &ifr) < 0) &&
845		    (ioctl(skfd, BOND_RELEASE_OLD, &ifr) < 0)) {
846			saved_errno = errno;
847			v_print("Master '%s': Error: SIOCBONDRELEASE failed: %s\n",
848				master_ifname, strerror(saved_errno));
849			return 1;
850		} else if (abi_ver < 1) {
851			/* The driver is using an old ABI, so we'll set the interface
852			 * down to avoid any conflicts due to same MAC/IP
853			 */
854			res = set_if_down(slave_ifname, slave_flags.ifr_flags);
855			if (res) {
856				fprintf(stderr,
857					"Slave '%s': Error: bring interface "
858					"down failed\n",
859					slave_ifname);
860			}
861		}
862	
863		/* set to default mtu */
864		set_slave_mtu(slave_ifname, 1500);
865	
866		return res;
867	}
868	
869	static int get_if_settings(char *ifname, struct dev_ifr ifra[])
870	{
871		int i;
872		int res = 0;
873	
874		for (i = 0; ifra[i].req_ifr; i++) {
875			strncpy(ifra[i].req_ifr->ifr_name, ifname, IFNAMSIZ);
876			res = ioctl(skfd, ifra[i].req_type, ifra[i].req_ifr);
877			if (res < 0) {
878				saved_errno = errno;
879				v_print("Interface '%s': Error: %s failed: %s\n",
880					ifname, ifra[i].req_name,
881					strerror(saved_errno));
882	
883				return saved_errno;
884			}
885		}
886	
887		return 0;
888	}
889	
890	static int get_slave_flags(char *slave_ifname)
891	{
892		int res = 0;
893	
894		strncpy(slave_flags.ifr_name, slave_ifname, IFNAMSIZ);
895		res = ioctl(skfd, SIOCGIFFLAGS, &slave_flags);
896		if (res < 0) {
897			saved_errno = errno;
898			v_print("Slave '%s': Error: SIOCGIFFLAGS failed: %s\n",
899				slave_ifname, strerror(saved_errno));
900		} else {
901			v_print("Slave %s: flags %04X.\n",
902				slave_ifname, slave_flags.ifr_flags);
903		}
904	
905		return res;
906	}
907	
908	static int set_master_hwaddr(char *master_ifname, struct sockaddr *hwaddr)
909	{
910		unsigned char *addr = (unsigned char *)hwaddr->sa_data;
911		struct ifreq ifr;
912		int res = 0;
913	
914		strncpy(ifr.ifr_name, master_ifname, IFNAMSIZ);
915		memcpy(&(ifr.ifr_hwaddr), hwaddr, sizeof(struct sockaddr));
916		res = ioctl(skfd, SIOCSIFHWADDR, &ifr);
917		if (res < 0) {
918			saved_errno = errno;
919			v_print("Master '%s': Error: SIOCSIFHWADDR failed: %s\n",
920				master_ifname, strerror(saved_errno));
921			return res;
922		} else {
923			v_print("Master '%s': hardware address set to "
924				"%2.2x:%2.2x:%2.2x:%2.2x:%2.2x:%2.2x.\n",
925				master_ifname, addr[0], addr[1], addr[2],
926				addr[3], addr[4], addr[5]);
927		}
928	
929		return res;
930	}
931	
932	static int set_slave_hwaddr(char *slave_ifname, struct sockaddr *hwaddr)
933	{
934		unsigned char *addr = (unsigned char *)hwaddr->sa_data;
935		struct ifreq ifr;
936		int res = 0;
937	
938		strncpy(ifr.ifr_name, slave_ifname, IFNAMSIZ);
939		memcpy(&(ifr.ifr_hwaddr), hwaddr, sizeof(struct sockaddr));
940		res = ioctl(skfd, SIOCSIFHWADDR, &ifr);
941		if (res < 0) {
942			saved_errno = errno;
943	
944			v_print("Slave '%s': Error: SIOCSIFHWADDR failed: %s\n",
945				slave_ifname, strerror(saved_errno));
946	
947			if (saved_errno == EBUSY) {
948				v_print("  The device is busy: it must be idle "
949					"before running this command.\n");
950			} else if (saved_errno == EOPNOTSUPP) {
951				v_print("  The device does not support setting "
952					"the MAC address.\n"
953					"  Your kernel likely does not support slave "
954					"devices.\n");
955			} else if (saved_errno == EINVAL) {
956				v_print("  The device's address type does not match "
957					"the master's address type.\n");
958			}
959			return res;
960		} else {
961			v_print("Slave '%s': hardware address set to "
962				"%2.2x:%2.2x:%2.2x:%2.2x:%2.2x:%2.2x.\n",
963				slave_ifname, addr[0], addr[1], addr[2],
964				addr[3], addr[4], addr[5]);
965		}
966	
967		return res;
968	}
969	
970	static int set_slave_mtu(char *slave_ifname, int mtu)
971	{
972		struct ifreq ifr;
973		int res = 0;
974	
975		ifr.ifr_mtu = mtu;
976		strncpy(ifr.ifr_name, slave_ifname, IFNAMSIZ);
977	
978		res = ioctl(skfd, SIOCSIFMTU, &ifr);
979		if (res < 0) {
980			saved_errno = errno;
981			v_print("Slave '%s': Error: SIOCSIFMTU failed: %s\n",
982				slave_ifname, strerror(saved_errno));
983		} else {
984			v_print("Slave '%s': MTU set to %d.\n", slave_ifname, mtu);
985		}
986	
987		return res;
988	}
989	
990	static int set_if_flags(char *ifname, short flags)
991	{
992		struct ifreq ifr;
993		int res = 0;
994	
995		ifr.ifr_flags = flags;
996		strncpy(ifr.ifr_name, ifname, IFNAMSIZ);
997	
998		res = ioctl(skfd, SIOCSIFFLAGS, &ifr);
999		if (res < 0) {
1000			saved_errno = errno;
1001			v_print("Interface '%s': Error: SIOCSIFFLAGS failed: %s\n",
1002				ifname, strerror(saved_errno));
1003		} else {
1004			v_print("Interface '%s': flags set to %04X.\n", ifname, flags);
1005		}
1006	
1007		return res;
1008	}
1009	
1010	static int set_if_up(char *ifname, short flags)
1011	{
1012		return set_if_flags(ifname, flags | IFF_UP);
1013	}
1014	
1015	static int set_if_down(char *ifname, short flags)
1016	{
1017		return set_if_flags(ifname, flags & ~IFF_UP);
1018	}
1019	
1020	static int clear_if_addr(char *ifname)
1021	{
1022		struct ifreq ifr;
1023		int res = 0;
1024	
1025		strncpy(ifr.ifr_name, ifname, IFNAMSIZ);
1026		ifr.ifr_addr.sa_family = AF_INET;
1027		memset(ifr.ifr_addr.sa_data, 0, sizeof(ifr.ifr_addr.sa_data));
1028	
1029		res = ioctl(skfd, SIOCSIFADDR, &ifr);
1030		if (res < 0) {
1031			saved_errno = errno;
1032			v_print("Interface '%s': Error: SIOCSIFADDR failed: %s\n",
1033				ifname, strerror(saved_errno));
1034		} else {
1035			v_print("Interface '%s': address cleared\n", ifname);
1036		}
1037	
1038		return res;
1039	}
1040	
1041	static int set_if_addr(char *master_ifname, char *slave_ifname)
1042	{
1043		struct ifreq ifr;
1044		int res;
1045		unsigned char *ipaddr;
1046		int i;
1047		struct {
1048			char *req_name;
1049			char *desc;
1050			int g_ioctl;
1051			int s_ioctl;
1052		} ifra[] = {
1053			{"IFADDR", "addr", SIOCGIFADDR, SIOCSIFADDR},
1054			{"DSTADDR", "destination addr", SIOCGIFDSTADDR, SIOCSIFDSTADDR},
1055			{"BRDADDR", "broadcast addr", SIOCGIFBRDADDR, SIOCSIFBRDADDR},
1056			{"NETMASK", "netmask", SIOCGIFNETMASK, SIOCSIFNETMASK},
1057			{NULL, NULL, 0, 0},
1058		};
1059	
1060		for (i = 0; ifra[i].req_name; i++) {
1061			strncpy(ifr.ifr_name, master_ifname, IFNAMSIZ);
1062			res = ioctl(skfd, ifra[i].g_ioctl, &ifr);
1063			if (res < 0) {
1064				int saved_errno = errno;
1065	
1066				v_print("Interface '%s': Error: SIOCG%s failed: %s\n",
1067					master_ifname, ifra[i].req_name,
1068					strerror(saved_errno));
1069	
1070				ifr.ifr_addr.sa_family = AF_INET;
1071				memset(ifr.ifr_addr.sa_data, 0,
1072				       sizeof(ifr.ifr_addr.sa_data));
1073			}
1074	
1075			strncpy(ifr.ifr_name, slave_ifname, IFNAMSIZ);
1076			res = ioctl(skfd, ifra[i].s_ioctl, &ifr);
1077			if (res < 0) {
1078				int saved_errno = errno;
1079	
1080				v_print("Interface '%s': Error: SIOCS%s failed: %s\n",
1081					slave_ifname, ifra[i].req_name,
1082					strerror(saved_errno));
1083	
1084			}
1085	
1086			ipaddr = (unsigned char *)ifr.ifr_addr.sa_data;
1087			v_print("Interface '%s': set IP %s to %d.%d.%d.%d\n",
1088				slave_ifname, ifra[i].desc,
1089				ipaddr[0], ipaddr[1], ipaddr[2], ipaddr[3]);
1090		}
1091	
1092		return 0;
1093	}
1094	
1095	/*
1096	 * Local variables:
1097	 *  version-control: t
1098	 *  kept-new-versions: 5
1099	 *  c-indent-level: 4
1100	 *  c-basic-offset: 4
1101	 *  tab-width: 4
1102	 *  compile-command: "gcc -Wall -Wstrict-prototypes -O -I/usr/src/linux/include ifenslave.c -o ifenslave"
1103	 * End:
1104	 */
Hide Line Numbers
About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Information is copyright its respective author. All material is available from the Linux Kernel Source distributed under a GPL License. This page is provided as a free service by mjmwired.net.