finstall(1M) finstall(1M)NAME finstall - installs A/UX software from specially prepared floppy disks SYNOPSIS finstall DESCRIPTION finstall provides a standard and consistent method for installing software from specially prepared floppy disks into an A/UX system. For information on how to prepare these disks, see Building A/UX Device Drivers, available through APDA (the Apple Programmers and Developers Association). Before starting an installation, finstall checks that you have enough space in the installation directory to install the software. During installation, finstall displays a series of messages and prompts. At one point you are asked whether you want to see a list of files to be installed. Another prompt asks you which floppy disk drive you will be using, and a third asks you which directory you want to use for the installed files. To accept the default answer indicated in the prompt, merely press RETURN. You can stop the finstall procedure at any time by entering the interrupt control code (usually by pressing CONTROL-C). The finstall program leaves an accounting of each of the files it installs. It stores this information in a file named installedfiles within the following path: /etc/finstall.d/vendor-name/app-name/version For example, if you have installed version 1.0 of an application called Tasty from a company named Goodbar, finstall leaves a list of the files that were installed in /etc/finstall.d/Goodbar/Tasty/1.0/installedfiles Customizing Installer Settings You can optionally specify certain default settings for finstall by creating a .finstallrc or /etc/finstallrc file before running finstall. The .finstallrc file could contain customizations for a specific user, whereas /etc/finstallrc would contain customizations intended to affect all users on a system. January 1992 1
finstall(1M) finstall(1M)These custom settings are established through shell variable assignments. Only certain shell variables used by finstall can be set this way, as the following sample shows: CON_TRIES=5 CTL_ALLOWRC=1 CTL_ASKDRIVE=1 CTL_ASKINSTALL=1 CTL_CHECKSPACE=1 CTL_TAKEDEFAULT=0 The following list provides a short description of each of the customizable variables: CON_TRIES The value of CON_TRIES establishes the number of tries a user is allowed before finstall terminates the installation because of invalid input. CTL_ALLOWRC A nonzero value causes finstall to honor the settings within a .finstallrc file, if one is present in the current working directory when finstall is run. If the value is zero, all custom settings for shell variables in a local .finstallrc file are ignored. CTL_ASKDRIVE A nonzero value causes finstall to ask which floppy disk drive to use. If the value is zero, the drive on the right side is used. CTL_ASKINSTALL A nonzero value causes finstall to ask which directory to install the software in. If the value is zero, the current working directory is used. CTL_CHECKSPACE A nonzero value causes finstall to check whether or not there is sufficient free space in the file system. If the value is zero, no check is performed before the installation proceeds. CTL_TAKEDEFAULT A nonzero value causes finstall to honor default values; even though prompts requesting input are still displayed, user entries are not obtained. If the value is zero, the usual prompt-response interaction is established. NOTES Users of the csh command shell need to run the rehash command after installing new software, to update the PATH 2 January 1992
finstall(1M) finstall(1M)variable. FILES ./.finstallrc Local default settings inside a shell-executable file /etc/finstallrc System-specific default settings inside a shell- executable file /usr/bin/finstall Executable file SEE ALSO newunix(1M) finstallrc(4) in A/UX Programmer's Reference Building A/UX Device Drivers (an APDA publication) January 1992 3