ucodeadm(1m) - update processor microcode

[mountaing]

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 target
       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  tar-
       get  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                 |system/core-os               |
       +-----------------------------+-----------------------------+
       |Interface Stability          |Committed                    |
       +-----------------------------+-----------------------------+

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



SunOS 5.11                        10 Jul 2007                     ucodeadm(1M)