sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget%/translations/zh_CN/networking/arcnetmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/zh_TW/networking/arcnetmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/it_IT/networking/arcnetmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ja_JP/networking/arcnetmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ko_KR/networking/arcnetmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/pt_BR/networking/arcnetmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/sp_SP/networking/arcnetmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh?/var/lib/git/docbuild/linux/Documentation/networking/arcnet.rsthKubhsection)}(hhh](htitle)}(hARCneth]hARCnet}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh field_list)}(hhh]hfield)}(hhh](h field_name)}(hAuthorh]hAuthor}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h*Avery Pennarun h]h paragraph)}(h)Avery Pennarun h](hAvery Pennarun <}(hhhhhNhNubh reference)}(hapenwarr@worldvisions.cah]hapenwarr@worldvisions.ca}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:apenwarr@worldvisions.cauh1jhhubh>}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhnote)}(hSee also arcnet-hardware.rst in this directory for jumper-setting and cabling information if you're like many of us and didn't happen to get a manual with your ARCnet card.h]h)}(hSee also arcnet-hardware.rst in this directory for jumper-setting and cabling information if you're like many of us and didn't happen to get a manual with your ARCnet card.h]hSee also arcnet-hardware.rst in this directory for jumper-setting and cabling information if you’re like many of us and didn’t happen to get a manual with your ARCnet card.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hj7ubah}(h]h ]h"]h$]h&]uh1j5hhhhhhhNubh transition)}(h----h]h}(h]h ]h"]h$]h&]uh1jOhhhKhhhhubh)}(h'These are the ARCnet drivers for Linux.h]h'These are the ARCnet drivers for Linux.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXThis new release (2.91) has been put together by David Woodhouse , in an attempt to tidy up the driver after adding support for yet another chipset. Now the generic support has been separated from the individual chipset drivers, and the source files aren't quite so packed with #ifdefs! I've changed this file a bit, but kept it in the first person from Avery, because I didn't want to completely rewrite it.h](hBThis new release (2.91) has been put together by David Woodhouse <}(hjihhhNhNubj)}(hdwmw2@infradead.orgh]hdwmw2@infradead.org}(hjqhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:dwmw2@infradead.orguh1jhjiubhX^>, in an attempt to tidy up the driver after adding support for yet another chipset. Now the generic support has been separated from the individual chipset drivers, and the source files aren’t quite so packed with #ifdefs! I’ve changed this file a bit, but kept it in the first person from Avery, because I didn’t want to completely rewrite it.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXUThe previous release resulted from many months of on-and-off effort from me (Avery Pennarun), many bug reports/fixes and suggestions from others, and in particular a lot of input and coding from Tomasz Motylewski. Starting with ARCnet 2.10 ALPHA, Tomasz's all-new-and-improved RFC1051 support has been included and seems to be working fine!h]hXWThe previous release resulted from many months of on-and-off effort from me (Avery Pennarun), many bug reports/fixes and suggestions from others, and in particular a lot of input and coding from Tomasz Motylewski. Starting with ARCnet 2.10 ALPHA, Tomasz’s all-new-and-improved RFC1051 support has been included and seems to be working fine!}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhtarget)}(h.. _arcnet-netdev:h]h}(h]h ]h"]h$]h&]refid arcnet-netdevuh1jhK!hhhhhhubh)}(hhh](h)}(h!Where do I discuss these drivers?h]h!Where do I discuss these drivers?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK$ubh)}(hARCnet discussions take place on netdev. Simply send your email to netdev@vger.kernel.org and make sure to Cc: maintainer listed in "ARCNET NETWORK LAYER" heading of Documentation/process/maintainers.rst.h](hCARCnet discussions take place on netdev. Simply send your email to }(hjhhhNhNubj)}(hnetdev@vger.kernel.orgh]hnetdev@vger.kernel.org}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:netdev@vger.kernel.orguh1jhjubhw and make sure to Cc: maintainer listed in “ARCNET NETWORK LAYER” heading of Documentation/process/maintainers.rst.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK&hjhhubeh}(h]( where-do-i-discuss-these-driversjeh ]h"](!where do i discuss these drivers? arcnet-netdeveh$]h&]uh1hhhhhhhhK$expect_referenced_by_name}jjsexpect_referenced_by_id}jjsubh)}(hhh](h)}(hOther Drivers and Infoh]hOther Drivers and Info}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK+ubh)}(hBYou can try JoAnne Schmitz's ARCNET page on the World Wide Web at:h]hDYou can try JoAnne Schmitz’s ARCNET page on the World Wide Web at:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubh block_quote)}(h'https://www.qis.net/~jschmitz/arcnet/ h]h)}(h%https://www.qis.net/~jschmitz/arcnet/h]j)}(hjh]h%https://www.qis.net/~jschmitz/arcnet/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1jhhhK/hjhhubeh}(h]other-drivers-and-infoah ]h"]other drivers and infoah$]h&]uh1hhhhhhhhK+ubh)}(hhh](h)}(hSupported Hardwareh]hSupported Hardware}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hhhhhK3ubh)}(hOnly PCI and PCI Express devices based on the COM20020 chipset are supported. This is the newest chipset from SMC with support for promiscuous mode (packet sniffing), extra diagnostic information, etc. These devices use the com20020_pci driver.h]hOnly PCI and PCI Express devices based on the COM20020 chipset are supported. This is the newest chipset from SMC with support for promiscuous mode (packet sniffing), extra diagnostic information, etc. These devices use the com20020_pci driver.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hj2hhubh)}(hdSupport for older chipsets and ISA and PCMCIA devices was previously available but has been removed.h]hdSupport for older chipsets and ISA and PCMCIA devices was previously available but has been removed.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hj2hhubeh}(h]supported-hardwareah ]h"]supported hardwareah$]h&]uh1hhhhhhhhK3ubh)}(hhh](h)}(hConfiguring the Driverh]hConfiguring the Driver}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghhhhhK?ubh)}(hYThe COM20020 driver will be loaded automatically at boot if a supported card is detected.h]hYThe COM20020 driver will be loaded automatically at boot if a supported card is detected.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjghhubh)}(hOIf the com20020_pci driver was compiled as a loadable module, the options are::h]hNIf the com20020_pci driver was compiled as a loadable module, the options are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjghhubh literal_block)}(hhnode= backplane= clockp= clockm= timeout= device=h]hhnode= backplane= clockp= clockm= timeout= device=}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKFhjghhubh)}(hIf the driver was compiled into the kernel, the same options can be specified on the kernel command line by prefixing them with `com20020_pci.`, as in the following example::h](hIf the driver was compiled into the kernel, the same options can be specified on the kernel command line by prefixing them with }(hjhhhNhNubhtitle_reference)}(h`com20020_pci.`h]h com20020_pci.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, as in the following example:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKIhjghhubj)}(hcom20020_pci.device=eth1h]hcom20020_pci.device=eth1}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKMhjghhubh)}(hXThe COM20020 chipset allows you to set the node ID in software, overriding the default which is still set in DIP switches on the card. If you don't have the COM20020 data sheets, and you don't know what the other options refer to, then they won't interest you - forget them.h]hXThe COM20020 chipset allows you to set the node ID in software, overriding the default which is still set in DIP switches on the card. If you don’t have the COM20020 data sheets, and you don’t know what the other options refer to, then they won’t interest you - forget them.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjghhubh)}(hOtherwise, ARCnet can be configured in a similar way to Ethernet, with the exception that ARCnet interface names begin with `arc`.h](h|Otherwise, ARCnet can be configured in a similar way to Ethernet, with the exception that ARCnet interface names begin with }(hjhhhNhNubj)}(h`arc`h]harc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKThjghhubeh}(h]configuring-the-driverah ]h"]configuring the driverah$]h&]uh1hhhhhhhhK?ubh)}(hhh](h)}(h How do I get it to work with...?h]h How do I get it to work with...?}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKYubhdefinition_list)}(hhh](hdefinition_list_item)}(hXNFS: Should be fine linux->linux, just pretend you're using Ethernet cards. oak.oakland.edu:/simtel/msdos/nfs has some nice DOS clients. There is also a DOS-based NFS server called SOSS. It doesn't multitask quite the way Linux does (actually, it doesn't multitask AT ALL) but you never know what you might need. With AmiTCP (and possibly others), you may need to set the following options in your Amiga nfstab: MD 1024 MR 1024 MW 1024 (Thanks to Christian Gottschling for this.) Probably these refer to maximum NFS data/read/write block sizes. I don't know why the defaults on the Amiga didn't work; write to me if you know more. h](hterm)}(hNFS:h]hNFS:}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKihj"ubh definition)}(hhh](h)}(hX5Should be fine linux->linux, just pretend you're using Ethernet cards. oak.oakland.edu:/simtel/msdos/nfs has some nice DOS clients. There is also a DOS-based NFS server called SOSS. It doesn't multitask quite the way Linux does (actually, it doesn't multitask AT ALL) but you never know what you might need.h]hX;Should be fine linux->linux, just pretend you’re using Ethernet cards. oak.oakland.edu:/simtel/msdos/nfs has some nice DOS clients. There is also a DOS-based NFS server called SOSS. It doesn’t multitask quite the way Linux does (actually, it doesn’t multitask AT ALL) but you never know what you might need.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hj8ubh)}(hWith AmiTCP (and possibly others), you may need to set the following options in your Amiga nfstab: MD 1024 MR 1024 MW 1024 (Thanks to Christian Gottschling for this.)h](hWith AmiTCP (and possibly others), you may need to set the following options in your Amiga nfstab: MD 1024 MR 1024 MW 1024 (Thanks to Christian Gottschling <}(hjIhhhNhNubj)}(hferksy@indigo.tng.oche.deh]hferksy@indigo.tng.oche.de}(hjQhhhNhNubah}(h]h ]h"]h$]h&]refuri mailto:ferksy@indigo.tng.oche.deuh1jhjIubh > for this.)}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKbhj8ubh)}(hProbably these refer to maximum NFS data/read/write block sizes. I don't know why the defaults on the Amiga didn't work; write to me if you know more.h]hProbably these refer to maximum NFS data/read/write block sizes. I don’t know why the defaults on the Amiga didn’t work; write to me if you know more.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghj8ubeh}(h]h ]h"]h$]h&]uh1j6hj"ubeh}(h]h ]h"]h$]h&]uh1j hhhKihjubj!)}(hXDOS: If you're using the freeware arcether.com, you might want to install the driver patch from my web page. It helps with PC/TCP, and also can get arcether to load if it timed out too quickly during initialization. In fact, if you use it on a 386+ you REALLY need the patch, really. h](j')}(hDOS:h]hDOS:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKphjubj7)}(hhh]h)}(hXIf you're using the freeware arcether.com, you might want to install the driver patch from my web page. It helps with PC/TCP, and also can get arcether to load if it timed out too quickly during initialization. In fact, if you use it on a 386+ you REALLY need the patch, really.h]hXIf you’re using the freeware arcether.com, you might want to install the driver patch from my web page. It helps with PC/TCP, and also can get arcether to load if it timed out too quickly during initialization. In fact, if you use it on a 386+ you REALLY need the patch, really.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhjubah}(h]h ]h"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]uh1j hhhKphjhhubj!)}(hWindows: See DOS :) Trumpet Winsock works fine with either the Novell or Arcether client, assuming you remember to load winpkt of course. h](j')}(hWindows:h]hWindows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKthjubj7)}(hhh]h)}(hSee DOS :) Trumpet Winsock works fine with either the Novell or Arcether client, assuming you remember to load winpkt of course.h]hSee DOS :) Trumpet Winsock works fine with either the Novell or Arcether client, assuming you remember to load winpkt of course.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]uh1j hhhKthjhhubj!)}(hXLAN Manager and Windows for Workgroups: These programs use protocols that are incompatible with the Internet standard. They try to pretend the cards are Ethernet, and confuse everyone else on the network. 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 networks. h](j')}(h'LAN Manager and Windows for Workgroups:h]h'LAN Manager and Windows for Workgroups:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKhjubj7)}(hhh](h)}(hThese programs use protocols that are incompatible with the Internet standard. They try to pretend the cards are Ethernet, and confuse everyone else on the network.h]hThese programs use protocols that are incompatible with the Internet standard. They try to pretend the cards are Ethernet, and confuse everyone else on the network.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjubh)}(hThe Linux ARCnet driver supports this protocol via the 'arc0e' device. See the section on "Multiprotocol Support" for more information.h]hThe Linux ARCnet driver supports this protocol via the ‘arc0e’ device. See the section on “Multiprotocol Support” for more information.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hjubh)}(hUsing the freeware Samba server and clients for Linux, you can now interface quite nicely with TCP/IP-based WfWg or Lan Manager networks.h]hUsing the freeware Samba server and clients for Linux, you can now interface quite nicely with TCP/IP-based WfWg or Lan Manager networks.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjubeh}(h]h ]h"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]uh1j hhhKhjhhubj!)}(hXWindows 95: Tools are included with Win95 that let you use either the LANMAN style network drivers (NDIS) or Novell drivers (ODI) to handle your ARCnet packets. If you use ODI, you'll need to use the 'arc0' device with Linux. If you use NDIS, then try the 'arc0e' device. See the "Multiprotocol Support" section below if you need arc0e, you're completely insane, and/or you need to build some kind of hybrid network that uses both encapsulation types. h](j')}(h Windows 95:h]h Windows 95:}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKhj.ubj7)}(hhh]h)}(hXTools are included with Win95 that let you use either the LANMAN style network drivers (NDIS) or Novell drivers (ODI) to handle your ARCnet packets. If you use ODI, you'll need to use the 'arc0' device with Linux. If you use NDIS, then try the 'arc0e' device. See the "Multiprotocol Support" section below if you need arc0e, you're completely insane, and/or you need to build some kind of hybrid network that uses both encapsulation types.h]hXTools are included with Win95 that let you use either the LANMAN style network drivers (NDIS) or Novell drivers (ODI) to handle your ARCnet packets. If you use ODI, you’ll need to use the ‘arc0’ device with Linux. If you use NDIS, then try the ‘arc0e’ device. See the “Multiprotocol Support” section below if you need arc0e, you’re completely insane, and/or you need to build some kind of hybrid network that uses both encapsulation types.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj@ubah}(h]h ]h"]h$]h&]uh1j6hj.ubeh}(h]h ]h"]h$]h&]uh1j hhhKhjhhubj!)}(hXOS/2: I've been told it works under Warp Connect with an ARCnet driver from SMC. You need to use the 'arc0e' interface for this. If you get the SMC driver to work with the TCP/IP stuff included in the "normal" Warp Bonus Pack, let me know. ftp.microsoft.com also has a freeware "Lan Manager for OS/2" client which should use the same protocol as WfWg does. I had no luck installing it under Warp, however. Please mail me with any results. h](j')}(hOS/2:h]hOS/2:}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKhj]ubj7)}(hhh](h)}(hI've been told it works under Warp Connect with an ARCnet driver from SMC. You need to use the 'arc0e' interface for this. If you get the SMC driver to work with the TCP/IP stuff included in the "normal" Warp Bonus Pack, let me know.h]hI’ve been told it works under Warp Connect with an ARCnet driver from SMC. You need to use the ‘arc0e’ interface for this. If you get the SMC driver to work with the TCP/IP stuff included in the “normal” Warp Bonus Pack, let me know.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjoubh)}(hftp.microsoft.com also has a freeware "Lan Manager for OS/2" client which should use the same protocol as WfWg does. I had no luck installing it under Warp, however. Please mail me with any results.h]hftp.microsoft.com also has a freeware “Lan Manager for OS/2” client which should use the same protocol as WfWg does. I had no luck installing it under Warp, however. Please mail me with any results.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjoubeh}(h]h ]h"]h$]h&]uh1j6hj]ubeh}(h]h ]h"]h$]h&]uh1j hhhKhjhhubj!)}(hXNetBSD/AmiTCP: These use an old version of the Internet standard ARCnet protocol (RFC1051) which is compatible with the Linux driver v2.10 ALPHA and above using the arc0s device. (See "Multiprotocol ARCnet" below.) ** Newer versions of NetBSD apparently support RFC1201. h](j')}(hNetBSD/AmiTCP:h]hNetBSD/AmiTCP:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hhhKhjubj7)}(hhh]h)}(hXThese use an old version of the Internet standard ARCnet protocol (RFC1051) which is compatible with the Linux driver v2.10 ALPHA and above using the arc0s device. (See "Multiprotocol ARCnet" below.) ** Newer versions of NetBSD apparently support RFC1201.h]hXThese use an old version of the Internet standard ARCnet protocol (RFC1051) which is compatible with the Linux driver v2.10 ALPHA and above using the arc0s device. (See “Multiprotocol ARCnet” below.) ** Newer versions of NetBSD apparently support RFC1201.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]uh1j hhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jhj hhhhhNubeh}(h]how-do-i-get-it-to-work-withah ]h"] how do i get it to work with...?ah$]h&]uh1hhhhhhhhKYubh)}(hhh](h)}(hUsing Multiprotocol ARCneth]hUsing Multiprotocol ARCnet}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hUThe ARCnet driver supports three protocols, each on its own "virtual network device":h]hYThe ARCnet driver supports three protocols, each on its own “virtual network device”:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hXY====== =============================================================== arc0 RFC1201 protocol, the official Internet standard which just happens to be 100% compatible with Novell's TRXNET driver. Version 1.00 of the ARCnet driver supported _only_ this protocol. arc0 is the fastest of the three protocols (for whatever reason), and allows larger packets to be used because it supports RFC1201 "packet splitting" operations. Unless you have a specific need to use a different protocol, I strongly suggest that you stick with this one. arc0e "Ethernet-Encapsulation" which sends packets over ARCnet that are actually a lot like Ethernet packets, including the 6-byte hardware addresses. This protocol is compatible with Microsoft's NDIS ARCnet driver, like the one in WfWg and LANMAN. Because the MTU of 493 is actually smaller than the one "required" by TCP/IP (576), there is a chance that some network operations will not function properly. The Linux TCP/IP layer can compensate in most cases, however, by automatically fragmenting the TCP/IP packets to make them fit. arc0e also works slightly more slowly than arc0, for reasons yet to be determined. (Probably it's the smaller MTU that does it.) arc0s The "[s]imple" RFC1051 protocol is the "previous" Internet standard that is completely incompatible with the new standard. Some software today, however, continues to support the old standard (and only the old standard) including NetBSD and AmiTCP. RFC1051 also does not support RFC1201's packet splitting, and the MTU of 507 is still smaller than the Internet "requirement," so it's quite possible that you may run into problems. It's also slower than RFC1201 by about 25%, for the same reason as arc0e. The arc0s support was contributed by Tomasz Motylewski and modified somewhat by me. Bugs are probably my fault. ====== =============================================================== h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK?uh1jhjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(harc0h]harc0}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj&ubah}(h]h ]h"]h$]h&]uh1j$hj!ubj%)}(hhh]h)}(hXRFC1201 protocol, the official Internet standard which just happens to be 100% compatible with Novell's TRXNET driver. Version 1.00 of the ARCnet driver supported _only_ this protocol. arc0 is the fastest of the three protocols (for whatever reason), and allows larger packets to be used because it supports RFC1201 "packet splitting" operations. Unless you have a specific need to use a different protocol, I strongly suggest that you stick with this one.h]hXRFC1201 protocol, the official Internet standard which just happens to be 100% compatible with Novell’s TRXNET driver. Version 1.00 of the ARCnet driver supported _only_ this protocol. arc0 is the fastest of the three protocols (for whatever reason), and allows larger packets to be used because it supports RFC1201 “packet splitting” operations. Unless you have a specific need to use a different protocol, I strongly suggest that you stick with this one.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj=ubah}(h]h ]h"]h$]h&]uh1j$hj!ubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(harc0eh]harc0e}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj]ubah}(h]h ]h"]h$]h&]uh1j$hjZubj%)}(hhh]h)}(hX"Ethernet-Encapsulation" which sends packets over ARCnet that are actually a lot like Ethernet packets, including the 6-byte hardware addresses. This protocol is compatible with Microsoft's NDIS ARCnet driver, like the one in WfWg and LANMAN. Because the MTU of 493 is actually smaller than the one "required" by TCP/IP (576), there is a chance that some network operations will not function properly. The Linux TCP/IP layer can compensate in most cases, however, by automatically fragmenting the TCP/IP packets to make them fit. arc0e also works slightly more slowly than arc0, for reasons yet to be determined. (Probably it's the smaller MTU that does it.)h]hX“Ethernet-Encapsulation” which sends packets over ARCnet that are actually a lot like Ethernet packets, including the 6-byte hardware addresses. This protocol is compatible with Microsoft’s NDIS ARCnet driver, like the one in WfWg and LANMAN. Because the MTU of 493 is actually smaller than the one “required” by TCP/IP (576), there is a chance that some network operations will not function properly. The Linux TCP/IP layer can compensate in most cases, however, by automatically fragmenting the TCP/IP packets to make them fit. arc0e also works slightly more slowly than arc0, for reasons yet to be determined. (Probably it’s the smaller MTU that does it.)}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjtubah}(h]h ]h"]h$]h&]uh1j$hjZubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(harc0sh]harc0s}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh](h)}(hXThe "[s]imple" RFC1051 protocol is the "previous" Internet standard that is completely incompatible with the new standard. Some software today, however, continues to support the old standard (and only the old standard) including NetBSD and AmiTCP. RFC1051 also does not support RFC1201's packet splitting, and the MTU of 507 is still smaller than the Internet "requirement," so it's quite possible that you may run into problems. It's also slower than RFC1201 by about 25%, for the same reason as arc0e.h]hX The “[s]imple” RFC1051 protocol is the “previous” Internet standard that is completely incompatible with the new standard. Some software today, however, continues to support the old standard (and only the old standard) including NetBSD and AmiTCP. RFC1051 also does not support RFC1201’s packet splitting, and the MTU of 507 is still smaller than the Internet “requirement,” so it’s quite possible that you may run into problems. It’s also slower than RFC1201 by about 25%, for the same reason as arc0e.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hpThe arc0s support was contributed by Tomasz Motylewski and modified somewhat by me. Bugs are probably my fault.h]hpThe arc0s support was contributed by Tomasz Motylewski and modified somewhat by me. Bugs are probably my fault.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubh)}(hYou can choose not to compile arc0e and arc0s into the driver if you want - this will save you a bit of memory and avoid confusion when eg. trying to use the "NFS-root" stuff in recent Linux kernels.h]hYou can choose not to compile arc0e and arc0s into the driver if you want - this will save you a bit of memory and avoid confusion when eg. trying to use the “NFS-root” stuff in recent Linux kernels.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hThe arc0e and arc0s devices are created automatically when you first ifconfig the arc0 device. To actually use them, though, you need to also ifconfig the other virtual devices you need. There are a number of ways you can set up your network then:h]hThe arc0e and arc0s devices are created automatically when you first ifconfig the arc0 device. To actually use them, though, you need to also ifconfig the other virtual devices you need. There are a number of ways you can set up your network then:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubhenumerated_list)}(hhh](h list_item)}(hXSingle Protocol. This is the simplest way to configure your network: use just one of the two available protocols. As mentioned above, it's a good idea to use only arc0 unless you have a good reason (like some other software, ie. WfWg, that only works with arc0e). If you need only arc0, then the following commands should get you going:: ifconfig arc0 MY.IP.ADD.RESS route add MY.IP.ADD.RESS arc0 route add -net SUB.NET.ADD.RESS arc0 [add other local routes here] If you need arc0e (and only arc0e), it's a little different:: ifconfig arc0 MY.IP.ADD.RESS ifconfig arc0e MY.IP.ADD.RESS route add MY.IP.ADD.RESS arc0e route add -net SUB.NET.ADD.RESS arc0e arc0s works much the same way as arc0e. h](h)}(hSingle Protocol.h]hSingle Protocol.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hThis is the simplest way to configure your network: use just one of the two available protocols. As mentioned above, it's a good idea to use only arc0 unless you have a good reason (like some other software, ie. WfWg, that only works with arc0e).h]hThis is the simplest way to configure your network: use just one of the two available protocols. As mentioned above, it’s a good idea to use only arc0 unless you have a good reason (like some other software, ie. WfWg, that only works with arc0e).}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hIIf you need only arc0, then the following commands should get you going::h]hHIf you need only arc0, then the following commands should get you going:}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(h}ifconfig arc0 MY.IP.ADD.RESS route add MY.IP.ADD.RESS arc0 route add -net SUB.NET.ADD.RESS arc0 [add other local routes here]h]h}ifconfig arc0 MY.IP.ADD.RESS route add MY.IP.ADD.RESS arc0 route add -net SUB.NET.ADD.RESS arc0 [add other local routes here]}hj@sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubh)}(h=If you need arc0e (and only arc0e), it's a little different::h]h>If you need arc0e (and only arc0e), it’s a little different:}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hifconfig arc0 MY.IP.ADD.RESS ifconfig arc0e MY.IP.ADD.RESS route add MY.IP.ADD.RESS arc0e route add -net SUB.NET.ADD.RESS arc0eh]hifconfig arc0 MY.IP.ADD.RESS ifconfig arc0e MY.IP.ADD.RESS route add MY.IP.ADD.RESS arc0e route add -net SUB.NET.ADD.RESS arc0e}hj\sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubh)}(h'arc0s works much the same way as arc0e.h]h'arc0s works much the same way as arc0e.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhj hhhhhNubj)}(hXMore than one protocol on the same wire. Now things start getting confusing. To even try it, you may need to be partly crazy. Here's what *I* did. :) Note that I don't include arc0s in my home network; I don't have any NetBSD or AmiTCP computers, so I only use arc0s during limited testing. I have three computers on my home network; two Linux boxes (which prefer RFC1201 protocol, for reasons listed above), and one XT that can't run Linux but runs the free Microsoft LANMAN Client instead. Worse, one of the Linux computers (freedom) also has a modem and acts as a router to my Internet provider. The other Linux box (insight) also has its own IP address and needs to use freedom as its default gateway. The XT (patience), however, does not have its own Internet IP address and so I assigned it one on a "private subnet" (as defined by RFC1597). To start with, take a simple network with just insight and freedom. Insight needs to: - talk to freedom via RFC1201 (arc0) protocol, because I like it more and it's faster. - use freedom as its Internet gateway. That's pretty easy to do. Set up insight like this:: ifconfig arc0 insight route add insight arc0 route add freedom arc0 /* I would use the subnet here (like I said to in "single protocol" above), but the rest of the subnet unfortunately lies across the PPP link on freedom, which confuses things. */ route add default gw freedom And freedom gets configured like so:: ifconfig arc0 freedom route add freedom arc0 route add insight arc0 /* and default gateway is configured by pppd */ Great, now insight talks to freedom directly on arc0, and sends packets to the Internet through freedom. If you didn't know how to do the above, you should probably stop reading this section now because it only gets worse. Now, how do I add patience into the network? It will be using LANMAN Client, which means I need the arc0e device. It needs to be able to talk to both insight and freedom, and also use freedom as a gateway to the Internet. (Recall that patience has a "private IP address" which won't work on the Internet; that's okay, I configured Linux IP masquerading on freedom for this subnet). So patience (necessarily; I don't have another IP number from my provider) has an IP address on a different subnet than freedom and insight, but needs to use freedom as an Internet gateway. Worse, most DOS networking programs, including LANMAN, have braindead networking schemes that rely completely on the netmask and a 'default gateway' to determine how to route packets. This means that to get to freedom or insight, patience WILL send through its default gateway, regardless of the fact that both freedom and insight (courtesy of the arc0e device) could understand a direct transmission. I compensate by giving freedom an extra IP address - aliased 'gatekeeper' - that is on my private subnet, the same subnet that patience is on. I then define gatekeeper to be the default gateway for patience. To configure freedom (in addition to the commands above):: ifconfig arc0e gatekeeper route add gatekeeper arc0e route add patience arc0e This way, freedom will send all packets for patience through arc0e, giving its IP address as gatekeeper (on the private subnet). When it talks to insight or the Internet, it will use its "freedom" Internet IP address. You will notice that we haven't configured the arc0e device on insight. This would work, but is not really necessary, and would require me to assign insight another special IP number from my private subnet. Since both insight and patience are using freedom as their default gateway, the two can already talk to each other. It's quite fortunate that I set things up like this the first time (cough cough) because it's really handy when I boot insight into DOS. There, it runs the Novell ODI protocol stack, which only works with RFC1201 ARCnet. In this mode it would be impossible for insight to communicate directly with patience, since the Novell stack is incompatible with Microsoft's Ethernet-Encap. Without changing any settings on freedom or patience, I simply set freedom as the default gateway for insight (now in DOS, remember) and all the forwarding happens "automagically" between the two hosts that would normally not be able to communicate at all. For those who like diagrams, I have created two "virtual subnets" on the same physical ARCnet wire. You can picture it like this:: [RFC1201 NETWORK] [ETHER-ENCAP NETWORK] (registered Internet subnet) (RFC1597 private subnet) (IP Masquerade) /---------------\ * /---------------\ | | * | | | +-Freedom-*-Gatekeeper-+ | | | | * | | \-------+-------/ | * \-------+-------/ | | | Insight | Patience (Internet) h](h)}(h(More than one protocol on the same wire.h]h(More than one protocol on the same wire.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~ubh)}(hNow things start getting confusing. To even try it, you may need to be partly crazy. Here's what *I* did. :) Note that I don't include arc0s in my home network; I don't have any NetBSD or AmiTCP computers, so I only use arc0s during limited testing.h](heNow things start getting confusing. To even try it, you may need to be partly crazy. Here’s what }(hjhhhNhNubhemphasis)}(h*I*h]hI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh did. :) Note that I don’t include arc0s in my home network; I don’t have any NetBSD or AmiTCP computers, so I only use arc0s during limited testing.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj~ubh)}(hI have three computers on my home network; two Linux boxes (which prefer RFC1201 protocol, for reasons listed above), and one XT that can't run Linux but runs the free Microsoft LANMAN Client instead.h]hI have three computers on my home network; two Linux boxes (which prefer RFC1201 protocol, for reasons listed above), and one XT that can’t run Linux but runs the free Microsoft LANMAN Client instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~ubh)}(hXeWorse, one of the Linux computers (freedom) also has a modem and acts as a router to my Internet provider. The other Linux box (insight) also has its own IP address and needs to use freedom as its default gateway. The XT (patience), however, does not have its own Internet IP address and so I assigned it one on a "private subnet" (as defined by RFC1597).h]hXiWorse, one of the Linux computers (freedom) also has a modem and acts as a router to my Internet provider. The other Linux box (insight) also has its own IP address and needs to use freedom as its default gateway. The XT (patience), however, does not have its own Internet IP address and so I assigned it one on a “private subnet” (as defined by RFC1597).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~ubh)}(hUTo start with, take a simple network with just insight and freedom. Insight needs to:h]hUTo start with, take a simple network with just insight and freedom. Insight needs to:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~ubj)}(h- talk to freedom via RFC1201 (arc0) protocol, because I like it more and it's faster. - use freedom as its Internet gateway. h]h bullet_list)}(hhh](j)}(hTtalk to freedom via RFC1201 (arc0) protocol, because I like it more and it's faster.h]h)}(hTtalk to freedom via RFC1201 (arc0) protocol, because I like it more and it's faster.h]hVtalk to freedom via RFC1201 (arc0) protocol, because I like it more and it’s faster.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h%use freedom as its Internet gateway. h]h)}(h$use freedom as its Internet gateway.h]h$use freedom as its Internet gateway.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhj~ubh)}(h5That's pretty easy to do. Set up insight like this::h]h6That’s pretty easy to do. Set up insight like this:}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj~ubj)}(hXifconfig arc0 insight route add insight arc0 route add freedom arc0 /* I would use the subnet here (like I said to in "single protocol" above), but the rest of the subnet unfortunately lies across the PPP link on freedom, which confuses things. */ route add default gw freedomh]hXifconfig arc0 insight route add insight arc0 route add freedom arc0 /* I would use the subnet here (like I said to in "single protocol" above), but the rest of the subnet unfortunately lies across the PPP link on freedom, which confuses things. */ route add default gw freedom}hj1sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj~ubh)}(h%And freedom gets configured like so::h]h$And freedom gets configured like so:}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj~ubj)}(hsifconfig arc0 freedom route add freedom arc0 route add insight arc0 /* and default gateway is configured by pppd */h]hsifconfig arc0 freedom route add freedom arc0 route add insight arc0 /* and default gateway is configured by pppd */}hjMsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj~ubh)}(hGreat, now insight talks to freedom directly on arc0, and sends packets to the Internet through freedom. If you didn't know how to do the above, you should probably stop reading this section now because it only gets worse.h]hGreat, now insight talks to freedom directly on arc0, and sends packets to the Internet through freedom. If you didn’t know how to do the above, you should probably stop reading this section now because it only gets worse.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj~ubh)}(hXNow, how do I add patience into the network? It will be using LANMAN Client, which means I need the arc0e device. It needs to be able to talk to both insight and freedom, and also use freedom as a gateway to the Internet. (Recall that patience has a "private IP address" which won't work on the Internet; that's okay, I configured Linux IP masquerading on freedom for this subnet).h]hXNow, how do I add patience into the network? It will be using LANMAN Client, which means I need the arc0e device. It needs to be able to talk to both insight and freedom, and also use freedom as a gateway to the Internet. (Recall that patience has a “private IP address” which won’t work on the Internet; that’s okay, I configured Linux IP masquerading on freedom for this subnet).}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj~ubh)}(hXQSo patience (necessarily; I don't have another IP number from my provider) has an IP address on a different subnet than freedom and insight, but needs to use freedom as an Internet gateway. Worse, most DOS networking programs, including LANMAN, have braindead networking schemes that rely completely on the netmask and a 'default gateway' to determine how to route packets. This means that to get to freedom or insight, patience WILL send through its default gateway, regardless of the fact that both freedom and insight (courtesy of the arc0e device) could understand a direct transmission.h]hXWSo patience (necessarily; I don’t have another IP number from my provider) has an IP address on a different subnet than freedom and insight, but needs to use freedom as an Internet gateway. Worse, most DOS networking programs, including LANMAN, have braindead networking schemes that rely completely on the netmask and a ‘default gateway’ to determine how to route packets. This means that to get to freedom or insight, patience WILL send through its default gateway, regardless of the fact that both freedom and insight (courtesy of the arc0e device) could understand a direct transmission.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj~ubh)}(hI compensate by giving freedom an extra IP address - aliased 'gatekeeper' - that is on my private subnet, the same subnet that patience is on. I then define gatekeeper to be the default gateway for patience.h]hI compensate by giving freedom an extra IP address - aliased ‘gatekeeper’ - that is on my private subnet, the same subnet that patience is on. I then define gatekeeper to be the default gateway for patience.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM*hj~ubh)}(h:To configure freedom (in addition to the commands above)::h]h9To configure freedom (in addition to the commands above):}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM.hj~ubj)}(hMifconfig arc0e gatekeeper route add gatekeeper arc0e route add patience arc0eh]hMifconfig arc0e gatekeeper route add gatekeeper arc0e route add patience arc0e}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM0hj~ubh)}(hThis way, freedom will send all packets for patience through arc0e, giving its IP address as gatekeeper (on the private subnet). When it talks to insight or the Internet, it will use its "freedom" Internet IP address.h]hThis way, freedom will send all packets for patience through arc0e, giving its IP address as gatekeeper (on the private subnet). When it talks to insight or the Internet, it will use its “freedom” Internet IP address.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM4hj~ubh)}(hXCYou will notice that we haven't configured the arc0e device on insight. This would work, but is not really necessary, and would require me to assign insight another special IP number from my private subnet. Since both insight and patience are using freedom as their default gateway, the two can already talk to each other.h]hXEYou will notice that we haven’t configured the arc0e device on insight. This would work, but is not really necessary, and would require me to assign insight another special IP number from my private subnet. Since both insight and patience are using freedom as their default gateway, the two can already talk to each other.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM9hj~ubh)}(hX~It's quite fortunate that I set things up like this the first time (cough cough) because it's really handy when I boot insight into DOS. There, it runs the Novell ODI protocol stack, which only works with RFC1201 ARCnet. In this mode it would be impossible for insight to communicate directly with patience, since the Novell stack is incompatible with Microsoft's Ethernet-Encap. Without changing any settings on freedom or patience, I simply set freedom as the default gateway for insight (now in DOS, remember) and all the forwarding happens "automagically" between the two hosts that would normally not be able to communicate at all.h]hXIt’s quite fortunate that I set things up like this the first time (cough cough) because it’s really handy when I boot insight into DOS. There, it runs the Novell ODI protocol stack, which only works with RFC1201 ARCnet. In this mode it would be impossible for insight to communicate directly with patience, since the Novell stack is incompatible with Microsoft’s Ethernet-Encap. Without changing any settings on freedom or patience, I simply set freedom as the default gateway for insight (now in DOS, remember) and all the forwarding happens “automagically” between the two hosts that would normally not be able to communicate at all.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM?hj~ubh)}(hFor those who like diagrams, I have created two "virtual subnets" on the same physical ARCnet wire. You can picture it like this::h]hFor those who like diagrams, I have created two “virtual subnets” on the same physical ARCnet wire. You can picture it like this:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMIhj~ubj)}(hXd [RFC1201 NETWORK] [ETHER-ENCAP NETWORK] (registered Internet subnet) (RFC1597 private subnet) (IP Masquerade) /---------------\ * /---------------\ | | * | | | +-Freedom-*-Gatekeeper-+ | | | | * | | \-------+-------/ | * \-------+-------/ | | | Insight | Patience (Internet)h]hXd [RFC1201 NETWORK] [ETHER-ENCAP NETWORK] (registered Internet subnet) (RFC1597 private subnet) (IP Masquerade) /---------------\ * /---------------\ | | * | | | +-Freedom-*-Gatekeeper-+ | | | | * | | \-------+-------/ | * \-------+-------/ | | | Insight | Patience (Internet)}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMMhj~ubeh}(h]h ]h"]h$]h&]uh1jhj hhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j hjhhhhhKubeh}(h]using-multiprotocol-arcnetah ]h"]using multiprotocol arcnetah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hIt works: what now?h]hIt works: what now?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM]ubh)}(h: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.h](h)}(h.:ref:`Send an email to netdev `h]hinline)}(hj%h]hSend an email to netdev}(hj)hhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1j'hj#ubah}(h]h ]h"]h$]h&]refdocnetworking/arcnet refdomainj4reftyperef refexplicitrefwarn reftarget arcnet-netdevuh1hhhhM_hjubh. 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.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM_hjhhubeh}(h]it-works-what-nowah ]h"]it works: what now?ah$]h&]uh1hhhhhhhhM]ubh)}(hhh](h)}(hIt doesn't work: what now?h]hIt doesn’t work: what now?}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZhhhhhMdubh)}(hDo the same as above, but also include the output of the ifconfig and route commands, as well as any pertinent log entries (ie. anything that starts with "arcnet:" and has shown up since the last reboot) in your mail.h]hDo the same as above, but also include the output of the ifconfig and route commands, as well as any pertinent log entries (ie. anything that starts with “arcnet:” and has shown up since the last reboot) in your mail.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMfhjZhhubh)}(hXIf you want to try fixing it yourself (I strongly recommend that you mail me about the problem first, since it might already have been solved) you may want to try some of the debug levels available. For heavy testing on D_DURING or more, it would be a REALLY good idea to kill your klogd daemon first! D_DURING displays 4-5 lines for each packet sent or received. D_TX, D_RX, and D_SKB actually DISPLAY each packet as it is sent or received, which is obviously quite big.h]hXIf you want to try fixing it yourself (I strongly recommend that you mail me about the problem first, since it might already have been solved) you may want to try some of the debug levels available. For heavy testing on D_DURING or more, it would be a REALLY good idea to kill your klogd daemon first! D_DURING displays 4-5 lines for each packet sent or received. D_TX, D_RX, and D_SKB actually DISPLAY each packet as it is sent or received, which is obviously quite big.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMjhjZhhubh)}(hXOnce the driver is running, you can run the arcdump shell script (available from me or in the full ARCnet package, if you have it) as root to list the contents of the arcnet buffers at any time. To make any sense at all out of this, you should grab the pertinent RFCs. (some are listed near the top of arcnet.c). arcdump assumes your card is at 0xD0000. If it isn't, edit the script.h]hXOnce the driver is running, you can run the arcdump shell script (available from me or in the full ARCnet package, if you have it) as root to list the contents of the arcnet buffers at any time. To make any sense at all out of this, you should grab the pertinent RFCs. (some are listed near the top of arcnet.c). arcdump assumes your card is at 0xD0000. If it isn’t, edit the script.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMrhjZhhubh)}(hyBuffers 0 and 1 are used for receiving, and Buffers 2 and 3 are for sending. Ping-pong buffers are implemented both ways.h]hyBuffers 0 and 1 are used for receiving, and Buffers 2 and 3 are for sending. Ping-pong buffers are implemented both ways.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMyhjZhhubh)}(hXIf your debug level includes D_DURING and you did NOT define SLOW_XMIT_COPY, the buffers are cleared to a constant value of 0x42 every time the card is reset (which should only happen when you do an ifconfig up, or when Linux decides that the driver is broken). During a transmit, unused parts of the buffer will be cleared to 0x42 as well. This is to make it easier to figure out which bytes are being used by a packet.h]hXIf your debug level includes D_DURING and you did NOT define SLOW_XMIT_COPY, the buffers are cleared to a constant value of 0x42 every time the card is reset (which should only happen when you do an ifconfig up, or when Linux decides that the driver is broken). During a transmit, unused parts of the buffer will be cleared to 0x42 as well. This is to make it easier to figure out which bytes are being used by a packet.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM|hjZhhubh)}(hIYou can change the debug level without recompiling the kernel by typing::h]hHYou can change the debug level without recompiling the kernel by typing:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZhhubj)}(h/ifconfig arc0 down metric 1xxx ifconfig arc0 uph]h/ifconfig arc0 down metric 1xxx ifconfig arc0 up}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjZhhubh)}(hwhere "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.h]hwhere “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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZhhubh)}(hNote 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.h]hNote 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZhhubh)}(hEIf you don't understand that, you probably don't want to know anyway.h]hIIf you don’t understand that, you probably don’t want to know anyway.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZhhubeh}(h]it-doesn-t-work-what-nowah ]h"]it doesn't work: what now?ah$]h&]uh1hhhhhhhhMdubeh}(h]arcnetah ]h"]arcnetah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj$footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj) error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}j]jasnameids}(j j jjjjj/j,jdjajjjjj jjWjTjju nametypes}(j jjj/jdjjj jWjuh}(j hjjjjj,jjaj2jjgjj jjjTjjjZu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h3Hyperlink target "arcnet-netdev" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehnjlineK!uh1j uba transformerN include_log] decorationNhhub.