custom(1M)

custom -- install specific portions of SCO UNIX packages

Synopsis

   /sbin/custom
   
   /sbin/custom -a [package . . .] [-m /dev/install | /dev/install1]
   

   /sbin/custom -s existing_product [-ilr [package . . .]] [-f [file]]

   	[-m /dev/install | /dev/install1]

Description

custom allows a privileged user to create a custom installation by selectively installing or deleting portions of packages written to be installed on SCO OpenServer (or earlier versions of SCO UNIX) systems. Note that custom+ and custom+ format package options are not supported. If you don't provide information custom needs, it will prompt you (see ``Non-interactive Mode'' and ``Interactive Mode,'' below).

Use pkgadd to install UnixWare packages which were created using the packaging format provided beginning with UNIX System V Release 4 [see pkgadd(1M) and pkginfo(4)].

Products are made up of one or more packages. In turn, packages are made up of one or more files. You can use custom to install or remove one or more packages for a product or list all the packages in a product. In addition, you can list the files in a package or install a single file from a package. By default, custom expects to install packages from floppy drive 0 (/dev/install).

Non-interactive mode

-a: If you haven't installed a product before, you can provide the names of the packages to install from that product. If you want to install all the packages from the product, use ALL, instead of naming packages. If you don't provide a package argument, custom will prompt you for the names of the packages you wish to install.
-s: If you want to install an additional package from a product that you previously installed, follow the -s option with the existing_product name and follow the -i option with the package name(s). existing_product can be a product id or a product name. If you don't provide these arguments, custom will prompt you for them.
-i: Install the specified package(s)
-r: Remove the specified package(s)
-l: List the files in the specified package(s)
-f: Install the specified file
-m: Install from device /dev/install for floppy drive 0 (the default) or /dev/install1 for floppy drive 1

Interactive mode

If you invoke custom with no arguments, custom provides a menu of the existing_products, beginning with the choice of adding a new product. Select this first choice, ``Add a Supported Product,'' if you want to install packages from a new product whose distribution medium is in floppy drive 0. If you want to install, remove, or list packages from an existing_product, select the number corresponding to that existing_product. If you choose to install packages from existing_product, its distribution medium must be in floppy drive 0.

Once you have made your selection from this first menu, you will be offered the following menu:

Install one or more packages
Remove one or more packages
List the available packages
List the files in a package
Install a single file
Select a new product to customize
Display current disk usage
Help

When you enter a menu option, you are prompted for further information. Options 1, 2, and 3 list available packages in the selected product. 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.

The following describes what actions are necessary for each menu option:

1. install package

After listing the packages available in a product, this option prompts for one or more package names. To specify multiple packages, separate the names by spaces. It calculates which installation volumes (distribution media) are needed and then prompts for the correct volume numbers.

2. remove package

After listing the packages available in a product, this option prompts for one or more package names to remove. To specify multiple packages, separate the names by spaces. It deletes the correct files in the specified package(s).

3. list available packages

This option lists all the packages in a product.

4. list files in a package

After listing the packages available in a product, this option prompts for one or more package names. To specify multiple packages, separate the names by spaces. It lists all files in the specified package(s).

5. install file

This option prompts for the name of a file from the product and retrieves that file from the distribution medium. The filename should be a full pathname relative to the root directory ``/''.

6. select new product

This option allows the user to work from a different product.

7. display current disk usage

This option reports current disk usage.

8. help

This option prints a page of instructions to help you use custom.

Files

/etc/perms/: information about existing_products

References

chmod(1), df(1M), du(1M), fixperm(1M), fixshlib(1M), pkgadd(1M), pkginfo(4), scompat(1),

Notices

When installing some applications, error messages such as ``bad gid'' or ``bad uid'' may be printed. These messages occur because some older UNIX systems assign UID and GID numbers differently from UnixWare systems. If necessary, the file and/or directory permissions can be altered with chmod(1) after installation.

Some packages require that SCOMPAT=3.2 be set before custom is run [see the NOTICES section of scompat(1)]; however, some package installation procedures may not allow this to occur.

If a package installation using the custom command is interrupted, the /etc/perms/pkgname file is not deleted. The package cannot be reinstalled until this file is removed. Remove the /etc/perms/pkgname file before resuming the installation.