Manual Pages for UNIX Operating System command usage for man ucodeadm

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  ven-
     dors.

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.






SunOS 5.11          Last change: 10 Jul 2007                    1






System Administration Commands                       ucodeadm(1M)



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  attri-
     butes:



SunOS 5.11          Last change: 10 Jul 2007                    2






System Administration Commands                       ucodeadm(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


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












































SunOS 5.11          Last change: 10 Jul 2007                    3