When run in search mode, acfg utilities search for installed adapters. Generally, acfgs search all I/O addresses that are supported by the adapter(s) and perform a presence test. The acfg reads the configuration options from the adapter and writes them to its output file. Typically, an acfg reads the I/O base address and any software configurable parameters on the adapter. If the adapter does not have software configurable options, just the I/O base address can be written out and other configuration information will be obtained from the AOF.
Output from acfg utilities overrides information found in AOFs. Thus, an acfg utility can be used to modify configurable options for different adapters that are supported by the same network adapter driver.
The names of the output files should be the counting numbers, with each file representing one adapter. The starting point is zero or the lowest number of a file not already in that directory. For example, if output_directory is empty and two adapters are found, the output file names would be 0 and 1. If there are already files in output_directory called 0, 1, and 2, the new output files would be named 3 and 4.
The output_directory should not be cleared or removed by acfg utilities before writing the output files. Return values are zero (0) for success (even if no adapters were found) and non-zero for failure.
Search mode is used to find all ISA adapters that are supported by the driver and read configuration information from the adapter. Even if it is not possible to read configuration information from the adapter, providing a search mode which does a presence test of all the known (or likely) I/O base addresses is useful. Such an acfg utilityis used to assist users in selecting adapters that are present in the machine when the network adapter driver is configured into the system.
The acfg script should read information from the adapter only if it is going to be stored in the Link Kit or is going to be written back to the adapter, as in the case of an ISA software configurable adapter.
As an example, this is the acfg output file for an SMC8013EWC card from the wdn driver's acfg utility.
BASE_IO: SELECT=240 IRQ: VALUES=2,3,4,5,7,10,11,15 SELECT=11 RAM: VALUES=a0000-f0000:1000(16) SELECT=d0000(16) MEDIA: VALUES=AUI/10BaseT,BNC/10BaseT/TwPr-NoLink SELECT=BNC/10BaseT ROM: SELECT=disabled ADAPTER: REQUIRED=IRQ,RAM,MEDIA ADVANCED=ROM AOF=wdn-isa DESCRIPTION=SMC801e#WC EtherCard Plus Elite 16 ComboThe acfg utility found an adapter that was slightly different than the one described in the wdn-isa AOF file. This acfg overrides the default ADAPTER:REQUIRED parameter to add the MEDIA attribute and adds the advanced RAM option. This adapter also has a different set of network connectors and IRQ lines than the defaults, so the acfg overrides the IRQ:VALUES and the MEDIA:VALUES attributes.