From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dl1-f65.google.com (mail-dl1-f65.google.com [74.125.82.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BF4971F63D9 for ; Mon, 18 May 2026 01:09:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.65 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779066561; cv=none; b=I3p/oE8YQ5w8Y8UIcWWfaSJnYqObU75wCN0tJ+bQO9SyTxRCVRQ18ZhAAJ/FbkDqhscuAqmY31IwW5ywaM93TZCzu3NjK1HiA7MUCGwstmOyRtZUi+kbnH/jwTUSeLHGV30v72+wSR9+6ysSpwXhdA7Kn/aiCeA2OI+BPXV/Js8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779066561; c=relaxed/simple; bh=HRtHHOEjvmTW762UEXwLH23ZntlzxDErqOorLAVh0UU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=KZOfVaQmOZlCmEc2aUttJUQ4kLQ/PQjqpo1HVaHgCvcRqqMjDHTIFsPc20jbvyp0bEzMBALGc81vmls6pp7B0lm5WPR1aQALJ/dKwyZLi+yFxPp+afhrdwHLDAsDyJi7dKNM3kQmJbJPrjAi7QPYrk+I/AAyrsqNyhu2xOrjOa0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Zqxz+AjE; arc=none smtp.client-ip=74.125.82.65 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Zqxz+AjE" Received: by mail-dl1-f65.google.com with SMTP id a92af1059eb24-1353c2f35cfso6943410c88.1 for ; Sun, 17 May 2026 18:09:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1779066559; x=1779671359; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=zHfRiZ9eAyYIM2WmjAuL1bwyh+6hR9i7GK44MUCPHv4=; b=Zqxz+AjEsHPjzyb5jaHsCLZ7pW8cOJSbyD9mevSh5u4UxgducvUHBR5AFJN34KNyMN kIjL+HFZt36P/7VuOjHlrd0yTd96FKCfMNZH1X+fVtHlT1PoGsFuLwv0hklBOHFTbDCI DqW8q8SIfOJrwQe/7s1XoP6p5WRr/rWNwqwc7lofcQ9sU1V1yOpJVpMJRyXluUIYMkht CX55yuSWQNnah5Wi+pKBe1Noo4PHPu0uIrAcwLD15SvOCSXA6MCjvVxYYvuTYGTNhORU ol3J9AsqJvxCTEmL7rSjlgPPvF1Af5o0Y1vzfFJnu/rJb1nBiN/jtyUWKnVQRbAHluPw LhXA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779066559; x=1779671359; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=zHfRiZ9eAyYIM2WmjAuL1bwyh+6hR9i7GK44MUCPHv4=; b=EXet6ZW7+FjJWZilYaX6J0Ptk2/U02Iqlt5SI5UJ5lSLzZHAPXVf+EO+Y39tO81tTE 4SqX+e1I5BOzZN9uQc8Vrpl9mmby3VlEm8Spq8zsEsVTrUrRZ4rVqARV103l9To4jax5 lSGLhNr+9DaVr9UFba8okUk+4spLEuaH6opnGSS7igk9OSwN3tHMoYdxQjTkQzMl92VQ WhbfuW2b3ynwAQxwOWA1WIi1dNKvK8ueFSF8Sj2vpfmbpfsPr6m2GIBO7y66HSlztU7z yJbUj/fD7VnP5Nf5Ok09gwxpwomJVjqmNYwI04hVep4kkzK76QltWpm+35bE2M0R7GDB nC6g== X-Gm-Message-State: AOJu0Yz4w6wVku6j1nwhXHt1KRw9eE+Owb3pKP5zIo3Qfae3mK1UVV3D n1AfpJUfdr2BwNFSwo1yTpCMhlW4tRlOMok+AbKINUxJ2h1ma8OL6Qbsk+JD+gAB0XI= X-Gm-Gg: Acq92OF1/ka9eVLvzoRQClaCBzMv0jvOkoiukUeXZ2yVcbHrG/dNJJrqLxWEQ+yF6Fl tPV/2XBc6jXo6Z06ei6DWHesZcSS/zlzzJ6ubSliOEDAmLulubEAE3rJBqC5DVnwWpq8ujYaCef TPJymKUCgm3IE678SqTmeRd5rut33cL9sSvkH/8QoDljOMvxLhzvKT9oRIj83aQSw5wMzJPxzgB QYRPhLO4Ayd608Ycm2l3MraSZ2ZGI6FVOvMSApy4VjXJZZ0TUdnzp84GAr1Ph1AKo5KY1OO8S5R w6YYrLzxfx+cZ73s+vuqZvxYlgDdvdNzAZxG4sob81DnMpi+3aCsWHuEaBB0EEDteTo+XT6OEWT h6AyTI7tIHEf5pm6Mdbp4yLTYzmWvdAEZoU9oUUy1Z5cgT2MkObQDTVCrvgQ0k5o5QiQthQcWmE VIeZmcQmWHl6bpN7EAsAq/ijMZnvZ+dukum5u6VWyEl+zEUKWH59qJ+SL/lyuSA88rmCK4MpQz9 PPQR2XOCN490cFwJEX7eKMdbfcM/TZC/ts1ifTsOGz36TPBeNOCp1s3KQWhdApekIHafR8jFbQA MMn2PupUfxmY4XQ1BQ== X-Received: by 2002:a05:7022:128c:b0:124:9dea:188d with SMTP id a92af1059eb24-1350483d04amr6044192c88.30.1779066558609; Sun, 17 May 2026 18:09:18 -0700 (PDT) Received: from ethan-latitude5420.. (host-127-24.cafrjco.fresno.ca.us.clients.pavlovmedia.net. [68.180.127.24]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-134cb5b3c20sm18891372c88.0.2026.05.17.18.09.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 May 2026 18:09:18 -0700 (PDT) From: Ethan Nelson-Moore To: netdev@vger.kernel.org, linux-doc@vger.kernel.org Cc: Ethan Nelson-Moore , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Shuah Khan Subject: [PATCH 6/7] docs: net: arcnet: remove outdated/irrelevant information; improve style Date: Sun, 17 May 2026 18:07:26 -0700 Message-ID: <20260518010739.80979-7-enelsonmoore@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260518010739.80979-1-enelsonmoore@gmail.com> References: <20260518010739.80979-1-enelsonmoore@gmail.com> Precedence: bulk X-Mailing-List: netdev@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The ARCnet documentation contains a lot of outdated and irrelevant information (such as changes in decades-old driver versions and messages from a former maintainer) and has some writing style issues. Remove this unnecessary information and improve the writing style. Also remove links to pages that no longer exist. Signed-off-by: Ethan Nelson-Moore --- Documentation/networking/arcnet-hardware.rst | 36 +++++----- Documentation/networking/arcnet.rst | 69 +++----------------- 2 files changed, 26 insertions(+), 79 deletions(-) diff --git a/Documentation/networking/arcnet-hardware.rst b/Documentation/networking/arcnet-hardware.rst index 17450e8e6ca7..37c016cee353 100644 --- a/Documentation/networking/arcnet-hardware.rst +++ b/Documentation/networking/arcnet-hardware.rst @@ -8,10 +8,8 @@ ARCnet Hardware .. note:: - 1) This file is a supplement to arcnet.rst. Please read that for general - driver configuration help. - 2) This file is no longer Linux-specific. It should probably be moved out - of the kernel sources. Ideas? + This file is a supplement to arcnet.rst. Please read that for general + driver configuration help. Because so many people (myself included) seem to have obtained ARCnet cards without manuals, this file contains a quick introduction to ARCnet hardware @@ -134,13 +132,11 @@ And now to the cabling. What you can connect together: network. 2. A card to a passive hub. Remember that all unused connectors on the hub - must be properly terminated with 93 Ohm (or something else if you don't - have the right ones) terminators. + must be properly terminated with 93 Ohm terminators (or something else if you + don't have the right ones), although the network may work without + terminators. - (Avery's note: oops, I didn't know that. Mine (TV cable) works - anyway, though.) - -3. A card to an active hub. Here is no need to terminate the unused +3. A card to an active hub. Here there is no need to terminate the unused connectors except some kind of aesthetic feeling. But, there may not be more than eleven active hubs between any two computers. That of course doesn't limit the number of active hubs on the network. @@ -150,7 +146,7 @@ And now to the cabling. What you can connect together: 5. An active hub to passive hub. Remember that you cannot connect two passive hubs together. The power loss -implied by such a connection is too high for the net to operate reliably. +implied by such a connection is too high for the network to operate reliably. An example of a typical ARCnet network:: @@ -163,8 +159,8 @@ An example of a typical ARCnet network:: | S -The BUS topology is very similar to the one used by Ethernet. The only -difference is in cable and terminators: they should be 93 Ohm. Ethernet +The BUS topology is very similar to the one used by 10BASE2 Ethernet. The only +difference is in cable and terminators: they should be 93 Ohm. 10BASE2 Ethernet uses 50 Ohm impedance. You use T connectors to put the computers on a single line of cable, the bus. You have to put terminators at both ends of the cable. A typical BUS ARCnet network looks like:: @@ -177,7 +173,7 @@ cable. A typical BUS ARCnet network looks like:: T - T connector But that is not all! The two types can be connected together. According to -the official documentation the only way of connecting them is using an active +the official documentation, the only way of connecting them is using an active hub:: A------T------T------TR @@ -186,7 +182,7 @@ hub:: | S -The official docs also state that you can use STAR cards at the ends of +The official docs also state that you can use STAR cards at the ends of a BUS network in place of a BUS card and a terminator:: S------T------T------S @@ -211,7 +207,7 @@ example:: | | S------T----H---S | S S B R S -A basically different cabling scheme is used with Twisted Pair cabling. Each +A completely different cabling scheme is used with Twisted Pair cabling. Each of the TP cards has two RJ (phone-cord style) connectors. The cards are then daisy-chained together using a cable connecting every two neighboring cards. The ends are terminated with RJ 93 Ohm terminators which plug into @@ -292,11 +288,13 @@ Setting the Jumpers Make sure you set ETS1 and ETS2 to the SAME VALUE for all cards on your network. -Also, on many cards (not mine, though) there are red and green LED's. -Vojtech Pavlik tells me this is what they mean: +LED Indicators +============== + +Many cards have red and green LEDs, which have the following meanings: =============== =============== ===================================== - GREEN RED Status + Green Red Status =============== =============== ===================================== OFF OFF Power off OFF Short flashes Cabling problems (broken cable or not diff --git a/Documentation/networking/arcnet.rst b/Documentation/networking/arcnet.rst index ce1b009bef96..4e541aa44aec 100644 --- a/Documentation/networking/arcnet.rst +++ b/Documentation/networking/arcnet.rst @@ -12,26 +12,6 @@ ARCnet and cabling information if you're like many of us and didn't happen to get a manual with your ARCnet card. -Since no one seems to listen to me otherwise, perhaps a poem will get your -attention:: - - This driver's getting fat and beefy, - But my cat is still named Fifi. - -Hmm, I think I'm allowed to call that a poem, even though it's only two -lines. Hey, I'm in Computer Science, not English. Give me a break. - -The point is: I REALLY REALLY REALLY REALLY REALLY want to hear from you if -you test this and get it working. Or if you don't. Or anything. - -ARCnet 0.32 ALPHA first made it into the Linux kernel 1.1.80 - this was -nice, but after that even FEWER people started writing to me because they -didn't even have to install the patch. - -Come on, be a sport! Send me a success report! - -(hey, that was even better than my original poem... this is getting bad!) - ---- These are the ARCnet drivers for Linux. @@ -62,31 +42,9 @@ netdev@vger.kernel.org and make sure to Cc: maintainer listed in Other Drivers and Info ---------------------- -You can try my ARCNET page on the World Wide Web at: - - http://www.qis.net/~jschmitz/arcnet/ - -Also, SMC (one of the companies that makes ARCnet cards) has a WWW site you -might be interested in, which includes several drivers for various cards -including ARCnet. Try: - - http://www.smc.com/ - -Performance Technologies makes various network software that supports -ARCnet: - - http://www.perftech.com/ or ftp to ftp.perftech.com. - -Novell makes a networking stack for DOS which includes ARCnet drivers. Try -FTPing to ftp.novell.com. - -You can get the Crynwr packet driver collection (including arcether.com, the -one you'll want to use with ARCnet cards) from -oak.oakland.edu:/simtel/msdos/pktdrvr. It won't work perfectly on a 386+ -without patches, though, and also doesn't like several cards. Fixed -versions are available on my WWW page, or via e-mail if you don't have WWW -access. +You can try JoAnne Schmitz's ARCNET page on the World Wide Web at: + https://www.qis.net/~jschmitz/arcnet/ Supported Hardware @@ -162,9 +120,8 @@ LAN Manager and Windows for Workgroups: are incompatible with the Internet standard. They try to pretend the cards are Ethernet, and confuse everyone else on the network. - However, v2.00 and higher of the Linux ARCnet driver supports this - protocol via the 'arc0e' device. See the section on "Multiprotocol - Support" for more information. + The Linux ARCnet driver supports this protocol via the 'arc0e' device. + See the section on "Multiprotocol Support" for more information. Using the freeware Samba server and clients for Linux, you can now interface quite nicely with TCP/IP-based WfWg or Lan Manager @@ -199,7 +156,7 @@ NetBSD/AmiTCP: Using Multiprotocol ARCnet -------------------------- -The ARCnet driver v2.10 ALPHA supports three protocols, each on its own +The ARCnet driver supports three protocols, each on its own "virtual network device": ====== =============================================================== @@ -391,7 +348,7 @@ can set up your network then: It works: what now? ------------------- -Send mail following :ref:`arcnet-netdev`. Describe your setup, preferably +:ref:`Send an email to netdev `. Describe your setup, preferably including driver version, kernel version, ARCnet card model, CPU type, number of systems on your network, and list of software in use. @@ -435,16 +392,8 @@ You can change the debug level without recompiling the kernel by typing:: where "xxx" is the debug level you want. For example, "metric 1015" would put you at debug level 15. Debug level 7 is currently the default. -Note that the debug level is (starting with v1.90 ALPHA) a binary -combination of different debug flags; so debug level 7 is really 1+2+4 or -D_NORMAL+D_EXTRA+D_INIT. To include D_DURING, you would add 16 to this, -resulting in debug level 23. +Note that the debug level is a binary combination of different debug flags; +debug level 7 is really 1+2+4 or D_NORMAL+D_EXTRA+D_INIT. To include D_DURING, +you would add 16 to this, resulting in debug level 23. If you don't understand that, you probably don't want to know anyway. -E-mail me about your problem. - - -I want to send money: what now? -------------------------------- - -Go take a nap or something. You'll feel better in the morning. -- 2.43.0