Commands Reference, Volume 5

udibuild Command

Purpose

Compiles and links third party udi drivers and metas.

Syntax

udibuild [ -a ] [ -g | -o ] [ -D Name [ = Def ] ] [ -U Name ] [ -T Directory ] [ -v ] [ udiprops.txt... ]

The udibuild command reads a udiprops.txt file describing a udi driver or udi meta, compiles, and links the source files into a udi module. By default, the udibuild command looks for a udiprops.txt file in the local directory if not specified on the command line. Errors are listed to stderr.

A local compiler must be installed. The udibuild 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.

Implementation Specifics

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

Flags

-a	Appends the sprops data from the sprops.txt file to the primary module. The default is not to attach the sprops information. This is usually done by the udimkpkg command and is provided for convenience.
-D Name [= Def ]	Defines Name as in #define directive. If Def is not specified, 1 is assumed. This is equivalent to the -D flag for the xlC compiler.
-g	Turns on the compiler debug flag, equivalent to the -g flag for the xlC compiler.
-o	Turns on optimization, equivalent to the -o flag for the xlC compiler.
-T Directory	Defines Directory to be a temporary working directory. The default is the local directory.
-U Name	Undefines Name as in #undef directive. This is equivalent to the -U flag for the xlC compiler.
-v	Enables listing of commands being executed to standard output.

Exit Status

This command returns the following exit values:

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

Examples

To build a udi module where the udiprops.txt file and all the source files are in the local directory, type:
```
udibuild
```
To build a udi module and list the commands being executed, type:
```
udibuild -v
```
To build a udi module using a temporary workspace of /tmp, type:
```
udibuild -T/tmp
```
To build multiple udi modules in multiple directories, type:
```
udibuild ./nic/udiprops.txt ./scsi/udiprops.txt
```
To build multiple udi modules in the same directory, type:
```
udibuild mydriver_rev1.txt mydriver_rev2.txt
```

Files

/usr/sbin/udibuild

Related Information

The udimkpkg command, udisetup command.