newconfig(1M) newconfig(1M)NAME newconfig - generates an up-to-date kernel SYNOPSIS newconfig [-k] [module]... [nomodule]... [nonet] [-v] ARGUMENTS -k Prevents newconfig from restoring any previous parameter settings that may have been set by kconfig so that the new kernel uses the default parameters. module Refers to one or more linkable modules that can be added to the kernel. You can use the following values for module, and you can specify them in uppercase or lowercase letters. Third-party vendors may provide support for additional values. ao Adds the driver for Ethernet for computers with a built-in Ethernet port. appletalk Adds the AppleTalk modules described as part of the next section, ``Description.'' as Adds the module for the Apple Ethernet NB Card. bnet Adds the module for Transmission Control Protocol/Internet Protocol (TCP/IP). cslip Adds the module for Compressed Serial Line/Internet Protocol (CSL/IP) module. dbgstreams Adds a module for support of an A/UX kernel debugger that is helpful when debugging Streams modules. debugger Adds a module for support of an A/UX kernel debugger. nfs Adds the modules for Network File System (NFS) and TCP/IP. scn Adds the module for the Apple Scanner connected through a SCSI port. For systems with multiple SCSI buses, it can be connected to any bus subject to the search limitations described in gd(7)). March 1993 1
newconfig(1M) newconfig(1M)sin Adds the module giving Macintosh applications access to the microphone port under A/UX. snd Adds the module giving Macintosh applications access to the sound hardware under A/UX. svfs Adds the module for System V file system (SVFS) support. tc Adds the module for supporting various magnetic tape devices, such as DDS-DC DAT, nine-track, 1/4" QIC-36, and eight-millimeter tape drives, as well as the Apple Tape Backup 40SC. ufs Adds the module for 4.2 Berkeley file system (UFS) support. nomodule Specifies the removal of module, which can also refer to multiple submodules. You can specify the module in uppercase or lowercase. nonet Generates a kernel that does not include the AppleTalk, TCP/IP, and NFS modules. -v Causes newconfig to display the commands it is running and to run each command with its verbose commentary option, if one exists. DESCRIPTION newconfig is a shell script that runs newunix and autoconfig. Based on the options specified on the newconfig command line, newunix copies and removes files from a source directory that determines the contents of the new kernel. While linking a new kernel, autoconfig searches the boot.d, init.d, master.d, and startup.d directories in /etc for files that are associated with each module included. Any modules placed in /etc/boot.d are included in the new kernel by autoconfig along with a base kernel. Preparing these ``search'' directories is the job of newunix. When adding a module, newunix copies the files from a ``repository'' directory, /etc/install.d. When removing a module, newunix simply removes the module and its associated files from the ``search'' directories. When you run newconfig with one or more module or nomodule arguments, you make a kernel that consists of the base kernel, the modules already in /etc/boot.d, and any modules that you specify on the newconfig command line, minus any 2 March 1993
newconfig(1M) newconfig(1M)nomodule modules. After a new kernel has been generated, newconfig runs the shell script, /etc/startup, which is produced by autoconfig. The /etc/startup script may ask you for system-configuration information. Finally, if you do not specify the -k option, newconfig runs kconfig to reestablish the kernel configuration parameters of the previous kernel. Note that newconfig does not prevent you from making a kernel that does not work. For example, if your root file system is a UFS file system and you specify noufs, newconfig makes a kernel that is incompatible with your file system. Also, newconfig does not prevent you from specifying an unworkable combination, such as noufs and nosvfs. To help you track changes to a kernel, you may wish to run the module_dump command before and after running newconfig, and then compare the new configuration to the old one. The new kernel does not effect your system unless you restart the system, allowing the startup process to automatically select and launch the new kernel according to the booting preferences that A/UX Startup contains (see StartupShell(8)). The /etc/boot.d directory contains files whose names correspond to the usual values for the module argument described in the ``Arguments'' section, earlier in this manual page. In addition, the directory contains other files whose names are unfamiliar. These modules are described in this section only for the sake of completeness; You do not specify these module names on the newconfig command line. adsp Contains the module for AppleTalk Data Streams Protocol (ADSP). at_atp Contains the STREAM module for AppleTalk Transaction Protocol (ATP). at_sig Contains a STREAM module for asynchronous ATP operations based on UNIX signals. bnet_dr Contains the socket module for TCP/IP networking. ddp Contains the module for AppleTalk DDP (Datagram Delivery Protocol). March 1993 3
newconfig(1M) newconfig(1M)devscsi Contains the module giving Macintosh applications access to the SCSI bus from inside A/UX. elap Contains the EtherTalk module for Link Access Protocol (LAP). line Contains the STREAM module for the line discipline. llap Contains the LocalTalk module for LAP. slots Contains the module for the slot library. toolbox Contains the module that supports calls to the Macintosh Toolbox. EXAMPLES The following examples should build smaller kernels than the supplied kernel because they explicitly leave out some of the standard modules. The following command makes a kernel that lacks support for the kernel debugger and for the sound module. /etc/newconfig nodebugger nosnd The following command makes a kernel that lacks support for the debugger, for the sound module, and for magnetic tape drives. /etc/newconfig nodebugger nosnd notc STATUS MESSAGES AND VALUES Here are the default messages that newconfig displays: newconfig: Making backup copies of important files. Indicates that newconfig is backing up the directories that autoconfig searches. If newconfig cannot make the new kernel (for instance, because the file system is full), it can restore the directories to their previous state. newconfig: Preparing to build a new A/UX kernel. Indicates that newconfig has called newunix to copy and remove files from the directories that autoconfig searches. newconfig: Building a new A/UX kernel (this may take several minutes). Indicates that newconfig has called autoconfig. When 4 March 1993
newconfig(1M) newconfig(1M)the kernel is made, autoconfig runs the initialization scripts, which may ask you for installation information. newconfig: Restoring kernel parameters. Indicates that newconfig has called kconfig to restore kernel settings. newconfig: Checking for any installation information. Indicates that newconfig is running /etc/startup, which may ask you for installation information. newconfig: The new configuration will take effect when the system is rebooted. Indicates that newconfig has completed successfully. FILES /etc/autoconfig Executable file called by newconfig to make the new kernel /etc/boot.d/* Module files that autoconfig always links along with a base kernel to generate a new kernel /etc/config.d/newunix Module file containing the base kernel that autoconfig always uses when generating kernels /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/newunix File containing a shell script called by newconfig /etc/startup File containing a shell script created by autoconfig /etc/startup.d/* Files containing scripts that /etc/startup runs each time the system is restarted SEE ALSO autoconfig(1M), kconfig(1M), module_dump(1M), newunix(1M) March 1993 5