custom(ADM) 19 June 1992 custom(ADM) Name custom - install software products and components Syntax custom [ -od ] [ -abilrv [ package ] ] [ -s set ] [ -m device ] [ -f [ file ] ] Description With custom you can create a custom installation by selectively install- ing or deleting portions of the UNIX system or other products. custom is executable only by the super user and is either interactive or can be invoked from the command line with several options. custom has three levels of operation: Complete Product, Service, and Service Component. At the Complete Product level, the entire product distribution (also known as a ``bundle'') is installed, which can consist of several products. At the Service level, groups of products that comprise a functional area are installed. At the Service Component level, an individual product, its packages, or individual files are installed. For example, a Complete Product could consist of several Ser- vices. In turn, a Service Component would include a number of packages. Files are extracted or deleted in packages. A package is a collection of individual files. You can also install additional products. You can list the available packages by using the custom command as described next. Usage To use custom interactively, enter: custom The custom main menu appears with the following options: Install Allows a product or system to be added. A window is first opened to select a ``New Product'' or a sys- tem set. When a new product is selected, you are given the choice of adding the ``Entire Product'', ``Packages'' or ``Files''. When ``Entire Product'' is chosen, custom calcu- lates which installation volumes (distribution media) are needed, then prompts for the correct volume numbers. If ``Packages'' is chosen, a list of all available packages in the currently selected set is displayed. Each line describes the package name, whether the package is fully installed, not installed or partially installed, the size of the package (in 512 byte blocks), and a one line description of the package contents. Multiple packages can be specified by marking them with the space bar. The selected packages will appear with asterisks. When executed, custom will prompt for insertion of the neces- sary volumes. (You cannot use custom to install the entire RTS package if that package is already partially installed. If this situation comes up, use fixperm(ADM) to determine which files are missing, and then use custom to install each file in- dividually.) If ``Files'' is chosen, you are prompted to select the package and then the filenames. custom then prompts for volumes. If a system set is selected, custom operates at the product level. You are given the option of installing the ``Complete Product'' (complete distribution), ``Services'' (a specific group of products), or ``Service Components'' (individual prod- ucts). Remove Deletes the correct files in the specified package/product. Select the product or package to be deleted just as you select a product or package to install. List Lists all files in the specified package or all packages in a product set. Quit Leaves custom. Options Three arguments are required for a completely non-interactive use of cus- tom: A set identifier (-o or -d) A command (-i, -r, -l,-f, -a, -v, -b, or -s) And either one or more package names, or a filename If any information is missing from the command line, custom prompts for the missing data. Only one of -o, or -d may be specified. These stand for: -o Operating System -d Development System Only one of -a, -b, -f, -i, -l, -r, -s, or -v may be specified, followed by an argument of the appropriate type (one or more package names, or a filename). These options perform the following: -i Install the specified package(s) -r Remove the specified package(s) -v Verbose output for installing and removing packages. For example, it gives information on command being run and on the size of the packages. -s set To install a specified set. A set is a collection of packages listed in a permsfile entry for a product. For example, ``ext'' is the Extended Utilities set of the operating system. -l List the files in the specified package(s) -b Enforces product dependencies specified in the ``bundle'' file for ``bundled'' products. -f Install the specified file -a Add a new product The -m flag allows the media device to be specified. The default is /dev/install (which is always the 0 device, as in /dev/fd0). This is very useful if the system has a 5.25-inch drive on /dev/fd0 and a 3.5- inch floppy on /dev/fd1, and it is necessary to install 3.5-inch media. For example: custom -m /dev/rfd196ds9 this will override the default device and use the one supplied with the -m flag. File /etc/perms/* See also df(C), du(C), fixperm(ADM), xinstall(ADM) Notes If you upgrade any part of your system, custom detects if you have a dif- ferent release and prompts you to insert the floppy volume that updates the custom data files. Likewise, if you insert an invalid product or a volume out of order, you will be prompted to reinsert the correct volume. Upon installation of the operating system, the RTS package is always entirely installed. Value added custom is an extension to AT&T System V developed by The Santa Cruz Operation, Inc.