autoconfig(1M) autoconfig(1M)NAME autoconfig - creates an up-to-date kernel SYNOPSIS autoconfig [-a] [-b module-directory] [-d init-scripts-directory] [-i base-kernel] [-I] [-k] [-l linker] [-L loadfile] [-m master-directory] [-M master-file] [-o kernel-file] [-s startup-scripts-directory] [-S script] [-t timeout] [-v] [-V] autoconfig -D [-i base-kernel] [-v] [-V] autoconfig -c [-v] [-V] ARGUMENTS -a Causes autoconfig to compare the current kernel with the cards in the NuBusTm slots. If the kernel matches, autoconfig exits and does not make a new kernel. If the kernel includes a module for a card that is not present in the NuBusTm slots, autoconfig makes a kernel that does not include the unmatched module. If the NuBusTm slots contain a card for which autoconfig cannot find a matching module, autoconfig makes a new kernel and displays this message: Warning cannot find driver(s) for device ID number Version number After making the new kernel, autoconfig runs the initialization scripts in /etc/init.d, as described for the -I option, and then automatically restarts the system. -b module-directory Causes autoconfig to search for driver modules in the directory specified by module-directory. -c Causes autoconfig to analyze the current master files and display a list of modules that it would include if it were to make a kernel. When used only with the -D, -v, and -V options, the -c option does not cause autoconfig to make a new kernel. -d init-scripts-directory Causes autoconfig to search for initialization scripts in the directory specified by init-scripts-directory instead of the default directory, /etc/init.d. Also causes autoconfig to search the absolute pathname specified by init-scripts-directory for initialization scripts instead of the default directory, /etc/init.d. -D Displays information about modules configured in the January 1992 1
autoconfig(1M) autoconfig(1M)base kernel. Also see the description of the -i option later in the ``Arguments'' section. -i base-kernel Causes autoconfig to use the absolute pathname specified by base-kernel as the base kernel instead of the default base kernel, /etc/config.d/newunix. -I Causes autoconfig to run the device-specific initialization scripts in /etc/init.d for all modules included in the new kernel. The work done by these scripts, such as making device nodes, needs to be done only once. -k Patches the currently running kernel. This option is not implemented. -l linker Causes autoconfig to use the linker specified by linker instead of the default linker, /bin/ld. This option is used for cross-development. -L loadfile Causes autoconfig to get information from the ASCII file specified by loadfile rather than getting the information from the cards in the NuBusTm slots. Each entry in loadfile has three fields in the following order: a slot number, an ID number, and a version number. With this information, autoconfig continues as if the devices specified in loadfile were in the system. Software developers use a loadfile to test their software installation when the hardware is not available. -m master-directory Causes autoconfig to search for master files in the directory specified by master-directory instead of the default directory, /etc/boot.d. -M master-file Specifies the absolute pathname of a master file that autoconfig is to create to link the errpt module. By convention, the value of master-file is /etc/master. -o kernel-file Causes autoconfig to make a kernel whose name is the value specified by kernel-file instead of the default, /etc/install.d/newunix. -s startup-scripts-directory Causes autoconfig to search for startup scripts in the directory specified by startup-scripts-directory 2 January 1992
autoconfig(1M) autoconfig(1M)instead of the default directory, /etc/startup.d. -S script Causes autoconfig to create a script whose absolute pathname is specified by script. By convention, the value of script is /etc/startup. -t timeout Causes autoconfig to call /etc/macquery to present a Macintosh alert box before restarting the system. The alert box contains an OK button whose behavior is controlled by the value of timeout. If the value of timeout is greater than 0, the alert's OK button is automatically selected after the number of seconds specified by timeout. If the value of timeout is 0, you must select the OK button in the alert box to continue the restart. -v Causes autoconfig to display verbose output that gives a step-by-step account of the work that it is doing. -V Causes autoconfig to display its current version number. DESCRIPTION autoconfig makes an up-to-date kernel. Before running autoconfig, you may want to run newunix to install files in or remove files from the directories that autoconfig uses to make a new kernel. The autoconfig command supports many options that are useful only to a software developer. You may prefer to run the newconfig command, which presents an interface that is easier to use and automatically runs the appropriate commands. If you do not use any options, autoconfig makes a new kernel in /unix by using the default base kernel, the modules that are in the default module directory, and the master scripts that are in the default master directory. When done, autoconfig displays status information about the new kernel and exits. To use the new kernel, run the sync command and then restart the system. If autoconfig makes the kernel in /unix, and you do not restart the system, the system may fail if the version of the kernel in memory does not match the new kernel on disk. EXAMPLES The file /etc/sysinitrc, which is executed each time you to start the system, runs autoconfig automatically in this way: autoconfig -t0 -a -o /unix -S /etc/startup -M /etc/master January 1992 3
autoconfig(1M) autoconfig(1M)The -a option causes autoconfig to compare the cards in the NuBusTm slots and build a new kernel if the current kernel does not match the cards in the NuBusTm slots. You can use the following command autoconfig -D -i /unix to see the modules that are currently included in the kernel. Here is an example of the output: Module Board Ver Prefix Maj Flags ---------- ----- ----- ---------- --- ----- scc sc 0 present char tty scsi hd 24 present block tty tt present soft streams str present soft at_sig at_sig_ included module svfs svfs_ included soft toolbox ui_ 4 included char fork exec exit ufs ufs included soft snd snd 9 included char elap elap_ 15 included stream ddp ddp 16 included stream llap llap_ 17 included stream atp atp included module at_atp atp_ included module at_pap pap_ included module at_papd papd_ included module bnet_dr BNET included soft ae6 8 0.00 ae6 dev addr slot network tc tc_ 18 included char slots slots included lib nfs_dr nfs included soft The first column lists the name of the module. The second and third columns list the ID and version numbers, respectively, as stored in the card's ROM. The fourth column lists the module's prefix. See master(4) for an explanation of prefix. The fifth column lists the module's corresponding major number, if any. See mknod(1M) for an explanation of major number. The sixth column contains keywords that describe the status of the module. The keyword present means that the module is part of the base kernel, which is normally /etc/config.d/newunix. The keyword included means that the module has been included because of a master file in /etc/master.d. 4 January 1992
autoconfig(1M) autoconfig(1M)FILES /dev/kmem Interface to kernel memory file /etc/%autoconfig Alert resources file /etc/autoconfig Executable file /etc/boot.d/* Module files that autoconfig links with the base kernel /etc/config.d/newunix Base kernel file /etc/init.d/* Files containing initialization scripts that autoconfig runs when invoked with the -I option /etc/master.d/* Files that tell autoconfig how to link the modules /etc/startup.d/* Script files that /etc/startup run each time the system is restarted /unix File containing the currently running kernel SEE ALSO errpt(1M), module_dump(1M), newconfig(1M), newunix(1M) ld(1), sync(1) in A/UX Command Reference master(4) in A/UX Programmer's Reference Building A/UX Device Drivers January 1992 5