ucodeadm(1M)						  System Administration Commands					      ucodeadm(1M)

NAME

       ucodeadm - update processor microcode

SYNOPSIS

       /usr/sbin/ucodeadm -v

       /usr/sbin/ucodeadm -umicrocode-text-file

       /usr/sbin/ucodeadm -i [-R path] microcode-text-file

DESCRIPTION

       The ucodeadm utility can be used to report running microcode revision on the processors, update microcode, or install microcode on the tar-
       get system to be used during the boot process.

       The microcode-text-file can be obtained from processor vendors.

OPTIONS

       -v			 Report microcode revision.

       -u microcode-text-file	 Update microcode on all cross-call interrupt ready processors.

       -i microcode-text-file	 Install microcode files on target system to be used during the next   boot cycle. The text file  name	must  have
				 the vendor name prefix,    such as "intel" or "amd".

				 By default the microcode files will be installed at:

				    /platform/i86pc/ucode/$VENDORSTR/

				 where VENDORSTR is either "GenuineIntel" or "AuthenticAMD".

       -R alternate path	 Install microcode path in the alternate path.

EXAMPLES

       Example 1 Reporting the Microcode Revision

       The following example displays the microcode revision that is currently running:

	 # ucodeadm -v

       Example 2 Updating the Processor Microcode

       The following example updates the processor microcode to intel-ucode.txt:

	 # ucodeadm -u intel-ucode.txt

       Example 3 Installing the Microcode on the Target System

       The following example installs the microcode on the target system, /export/ucode-path:

	 # ucodeadm -i -R /export/ucode-path intel-ucode.txt

       If  an alternate path is used when installing the microcode on the target system, the installed microcode file is not used on the next boot
       cycle.

EXIT STATUS

       The following exit values are returned:

       0     Successful completion.

       >0    An error occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       psradm(1M), psrinfo(1M), attributes(5)

SunOS 5.11							    10 Jul 2007 						      ucodeadm(1M)