lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [day] [month] [year] [list]
Message-ID: <Pine.LNX.4.64.0709030725420.3962@localhost.localdomain>
Date:	Mon, 3 Sep 2007 07:30:33 -0400 (EDT)
From:	"Robert P. J. Day" <rpjday@...dspring.com>
To:	netdev@...r.kernel.org
cc:	Geert Uytterhoeven <geert@...ux-m68k.org>
Subject: [PATCH] NET: Officially deprecate "ether=" and schedule for removal.


Officially deprecate the boot-time "ether=" option in favour of
"netdev=", update the documentation accordingly in various places, and
schedule removal for September of 2008.

Signed-off-by: Robert P. J. Day <rpjday@...dspring.com>

---

  i realize that some people have strong feelings about removing
options because of backward compatibility, so i'm easy regarding this
submission.  i just had the patch lying around so i figured i'd send
it on and someone higher up the food chain can make the call one way
or the other.

  compile and boot-time tested on i386 with "make defconfig".


 Documentation/feature-removal-schedule.txt |    6 ++++++
 Documentation/kernel-parameters.txt        |    2 ++
 Documentation/m68k/kernel-options.txt      |    6 +++++-
 Documentation/networking/3c505.txt         |    3 ++-
 drivers/net/3c59x.c                        |    3 ++-
 drivers/net/atp.c                          |    2 +-
 drivers/net/es3210.c                       |    5 +++++
 net/ethernet/eth.c                         |   13 ++++++++++++-
 8 files changed, 35 insertions(+), 5 deletions(-)

diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt
index b9a3fdc..656a71a 100644
--- a/Documentation/feature-removal-schedule.txt
+++ b/Documentation/feature-removal-schedule.txt
@@ -298,3 +298,9 @@ Why:	All mthca hardware also supports MSI-X, which provides
 Who:	Roland Dreier <rolandd@...co.com>

 ---------------------------
+
+What:	"ether=" boot-time option
+When:	September 2008
+Why:	Obsoleted by newer and equivalent "netdev=" option.
+Who:	Robert P. J. Day <rpjday@...dspring.com> or whoever else wants to
+	do it when the time comes.
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt
index b41cde3..47a9cf1 100644
--- a/Documentation/kernel-parameters.txt
+++ b/Documentation/kernel-parameters.txt
@@ -621,6 +621,8 @@ and is between 256 and 4096 characters. It is defined in the file
 	ether=		[HW,NET] Ethernet cards parameters
 			This option is obsoleted by the "netdev=" option, which
 			has equivalent usage. See its documentation for details.
+			"ether=" has been scheduled for removal -- see the file
+			Documentation/feature-removal-schedule.txt.

 	eurwdt=		[HW,WDT] Eurotech CPU-1220/1410 onboard watchdog.
 			Format: <io>[,<irq>]
diff --git a/Documentation/m68k/kernel-options.txt b/Documentation/m68k/kernel-options.txt
index 59108ce..3ec32d2 100644
--- a/Documentation/m68k/kernel-options.txt
+++ b/Documentation/m68k/kernel-options.txt
@@ -218,7 +218,7 @@ drive (with "root=").
 3) General Device Options (Amiga and Atari)
 ===========================================

-3.1) ether=
+3.1) ether=  [Equivalently, netdev=]
 -----------

 Syntax: ether=[<irq>[,<base_addr>[,<mem_start>[,<mem_end>]]]],<dev-name>
@@ -233,6 +233,10 @@ Linux/m68k (ariadne, a2065, hydra) don't use them because Zorro boards
 are really Plug-'n-Play, so the "ether=" option is useless altogether
 for Linux/m68k.

+  NOTE:  The "ether=" option is deprecated in favour of the newer
+"netdev=" option.  "ether=" has been scheduled for removal -- see the
+file Documentation/feature-removal-schedule.txt for details.
+

 3.2) hd=
 --------
diff --git a/Documentation/networking/3c505.txt b/Documentation/networking/3c505.txt
index b9d5b72..d79d31d 100644
--- a/Documentation/networking/3c505.txt
+++ b/Documentation/networking/3c505.txt
@@ -5,7 +5,8 @@ The default DMA channel is 6; this is _not_ autoprobed, so you must
 make sure you configure it correctly.  If loading the driver as a
 module, you can do this with "modprobe 3c505 dma=n".  If the driver is
 linked statically into the kernel, you must either use an "ether="
-statement on the command line, or change the definition of ELP_DMA in 3c505.h.
+(or equivalent and preferred "netdev=") statement on the command line,
+or change the definition of ELP_DMA in 3c505.h.

 The driver will warn you if it has to fall back on the compiled in
 default DMA channel.
diff --git a/drivers/net/3c59x.c b/drivers/net/3c59x.c
index a8c0f43..0ae3561 100644
--- a/drivers/net/3c59x.c
+++ b/drivers/net/3c59x.c
@@ -1043,7 +1043,8 @@ static int __devinit vortex_probe1(struct device *gendev,
 	if (dev->mem_start) {
 		/*
 		 * The 'options' param is passed in as the third arg to the
-		 * LILO 'ether=' argument for non-modular use
+		 * LILO 'ether=' (or equivalent and preferred 'netdev=') argument
+		 * for non-modular use
 		 */
 		option = dev->mem_start;
 	}
diff --git a/drivers/net/atp.c b/drivers/net/atp.c
index 82d78ff..d9cd8bb 100644
--- a/drivers/net/atp.c
+++ b/drivers/net/atp.c
@@ -114,7 +114,7 @@ static int xcvr[NUM_UNITS]; 			/* The data transfer mode. */

 	The data transfer mode is stored in the 'dev->if_port' field.  Its default
 	value is '4'.  It may be overridden at boot-time using the third parameter
-	to the "ether=..." initialization.
+	to the "ether=..." (or equivalent and preferred "netdev=...") initialization.

 	The header file <atp.h> provides inline functions that encapsulate the
 	register and data access methods.  These functions are hand-tuned to
diff --git a/drivers/net/es3210.c b/drivers/net/es3210.c
index 822e5bf..fdfbd59 100644
--- a/drivers/net/es3210.c
+++ b/drivers/net/es3210.c
@@ -40,6 +40,11 @@
 	   these registers is disabled there. In the meantime, boot with:
 	   ether=<IRQ>,0,0x<shared_mem_addr>,eth0 to override the IRQ and
 	   shared memory detection. (The i/o port detection is okay.)
+
+	   NOTE:  The "ether=" option has been deprecated in favour of the
+	   newer and equivalent "netdev=" option, and has been scheduled for
+	   removal.  See Documentation/feature-removal-schedule.txt for
+	   details.

 	2) Module support currently untested. Probably works though.

diff --git a/net/ethernet/eth.c b/net/ethernet/eth.c
index 12c7657..45a3e9c 100644
--- a/net/ethernet/eth.c
+++ b/net/ethernet/eth.c
@@ -31,6 +31,8 @@
  *				  older network drivers and IFF_ALLMULTI.
  *	Christer Weinigel	: Better rebuild header message.
  *             Andrew Morton    : 26Feb01: kill ether_setup() - use netdev_boot_setup().
+ *             Robert P. J. Day : Add ether_boot_setup() to allow deprecation warning
+				  for "ether=" boot-time option.
  *
  *		This program is free software; you can redistribute it and/or
  *		modify it under the terms of the GNU General Public License
@@ -60,7 +62,16 @@
 #include <asm/uaccess.h>
 #include <asm/system.h>

-__setup("ether=", netdev_boot_setup);
+static int __init
+ether_boot_setup(char *str)
+{
+	printk(KERN_NOTICE "The 'ether' option is deprecated and "
+		"is scheduled for removal in late 2008\n");
+	printk(KERN_NOTICE "Use 'netdev=<value>' instead\n");
+	return netdev_boot_setup(str);
+}
+
+__setup("ether=", ether_boot_setup);

 /**
  * eth_header - create the Ethernet header




-- 
========================================================================
Robert P. J. Day
Linux Consulting, Training and Annoying Kernel Pedantry
Waterloo, Ontario, CANADA

http://crashcourse.ca
========================================================================
-
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ