Commands Reference, Volume 5

udisetup Command

Purpose

Installs available software products in a udi installation package.

Syntax

"To Install Installable Software"

udisetup [ -b ] [ -d Device ] [ -T Directory ] [ -v ] [ -X ] [ -w ] [ FilesetName [ Level ]... | UdiPkg... | -f ListFile | all ]

"To Deinstall (Remove) Installed Software"

udisetup -u [ -v ] [ FilesetName [ Level ]... | UdiPkg | -f ListFile ]

"To Clean Up a Failed Installation"

udisetup -C [ -v ]

"To List All Installable Software"

udisetup { -l | -L } [ -d Device ] [ -v ]

"To Copy a Fileset"

udisetup -c -d DstDir -s {SrcDir | UdiPkg } [ -v ] [ FilesetName... | -f ListFile ]

The udisetup command installs, uninstalls copies, and lists udi filesets stored in a udi package. If source files are in the udi package and a local compiler and linker are available, then the command builds the module from the source files before installing.

A local compiler must be installed. The command by default uses the compiler defined by the user environment variable UDI_CC. If UDI_CC is not defined, the command checks if /usr/bin/cc exists. A local linker must be installed. The command by default uses the linker defined by the user environment variable UDI_LD. If UDI_LD is not defined, the command checks if /usr/bin/ld exists. The default action is to install all filesets contained in all udi packages found in the local directory.

Implementation Specifics

This command is supported only on the Itanium-based platform. It is not supported on POWER-based platforms.

Flags

-b	Specifies boot mode only for installation of drivers during system installation. Note: This flag should only be used by the installp command, not by the user at the command line.
-c	Copies udi package(s) from the source to the destination directory, based on the specified filesets. The source can be a path to a single udi package, a directory containing multiple udi packages or a special file (cdrom,tape) containing one or more udi packages.
-C	Cleans up after an interrupted installation and attempts to remove all incomplete pieces of the previous installation.
-d Device	Specifies where the installation media can be found. This can be a hardware device such as tape or diskette, it can be a directory that contains installation images, or it can be the installation image file itself. The default device is the local directory.
-f	Specifies a file containing a list of filesets to process.
-l	Lists all the software products contained on the installation media. Default is to list all filesets contained in all udi packages found in the local directory. No installation occurs.
-L	Lists all the software products contained on the installation media in colon-separated output. Default is to list all filesets contained in all udi packages found in the local directory. No installation occurs.
-p	Performs a preview of an action by running all preinstallation checks for the specified action.
-s	Specifies the source directory.
-T Directory	Defines Directory to be a temporary working directory. The default is the local directory.
-u	Deinstalls the specified filesets or all filesets contained in the specified udi package(s). Default is to deinstall all filesets found in the udi package files located in the local directory.
-v	Enables listing of commands being executed to standard output.
-w	Does not wildcard FilesetName. Use this flag from SMIT so that only an exact match of the fileset chosen is installed. For example, if you choose foo.rte, foo.rte.bar is not automatically pulled in, as it would be by default without the -w flag.
-X	Attempts to expand any filesystem where there is insufficient space to do the installation. This option expands filesystems based on current available space and size estimates that are provided by the software product package. Default is not to expand the filesystem.

Exit Status

This command returns the following exit values:

0	The udi module files were successfully installed.
1	An error occurred. An error message is listed to stderr.

Examples

To list all software products on the CDROM /dev/cd0, type:
```
udisetup -L -d/dev/cd0
```
To list all filesets in a single udi package, type:
```
udisetup -L -d/tmp/mydriver.udi
```
To install all filesets located in the directory /usr/sys/inst.images/udi and expand filesystems, if necessary, type:
```
udisetup -X -d/usr/sys/inst.images/udi all
```
To install only one fileset located in the directory /tmp that is named devices.pci.4f111100.pseudo, type:
```
udisetup -d/tmp devices.pci.4f111100.pseudo
```
To install the filesets contained in an ascii file named fileset.lst where the udi packages are located on the cdrom /dev/cd0, type:
```
udisetup -d/dev/cd0 -ffileset.lst
```
To remove a fileset named devices.pci.4f111100.pseudo, type:
```
udisetup -u devices.pci.4f111100.pseudo
```
To copy the udi package from the cdrom that contains the fileset devices.pci.4f111100.pseudo to the directory /tmp, type:
```
udisetup -c -s/dev/cd0 -d/tmp devices.pci.4f111100.pseudo
```

Files

/usr/sbin/udisetup

Related Information

The udibuild command, udimkpkg command.