home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / flash.z / flash
Encoding:
Text File  |  2001-04-17  |  8.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ffffllllaaaasssshhhh((((1111MMMM))))                                                            ffffllllaaaasssshhhh((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      flash - reprogram the flash PROM hardware on Origin and OCTANE machines
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ffffllllaaaasssshhhh [ ----aaaa ] [ ----cccc ] [ ----dddd ] [ ----DDDD ] [ ----ffff ] [ ----FFFF ] [ ----iiii ] [ ----mmmm _m_o_d_u_l_e__i_d ]
  13.           [ ----nnnn ] [ ----oooo ] [ ----pppp _d_i_r__n_a_m_e ] [ ----PPPP _i_m_g__n_a_m_e ] [ ----ssss _s_l_o_t__n_a_m_e ] [ ----SSSS ]
  14.           [ ----vvvv ] [ ----VVVV ]
  15.  
  16.      TTTThhhheeee SSSSGGGGIIII OOOOrrrriiiiggggiiiinnnn 3333000000000000 sssseeeerrrrvvvveeeerrrr sssseeeerrrriiiieeeessss....
  17.      ffffllllaaaasssshhhh [ ----aaaa ] [ ----dddd ] [ ----DDDD ] [ ----ffff ] [ ----FFFF ] [ ----bbbb _b_r_i_c_k__i_d ]
  18.            [ ----oooo ] [ ----pppp _d_i_r__n_a_m_e ] [ ----PPPP _i_m_g__n_a_m_e ] [ ----SSSS ]
  19.            [ ----vvvv ] [ ----VVVV ]
  20.  
  21.      ffffllllaaaasssshhhh ----LLLL
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _f_l_a_s_h allows a user to manage the flash PROMs on the IO and CPU boards of
  25.      Origin systems, the base system board on OCTANE systems and CPU boards on
  26.      the SGI Origin 3000 server series.  Without options, the command flashes
  27.      all appropriate boards on the machine with the PROM images found in
  28.      /_u_s_r/_c_p_u/_f_i_r_m_w_a_r_e.  Normally, _f_l_a_s_h is executed automatically during the
  29.      installation of a new release of IRIX.  A customer should rarely need to
  30.      use it directly.  You must have superuser privilege to use this command.
  31.  
  32.      By default on Origin systems, _f_l_a_s_h takes the current configuration
  33.      values (such as processor speed and cache size) that are currently stored
  34.      in the CPU board PROM and uses these values when flashing the new images.
  35.      Without options, _f_l_a_s_h proceeds in parallel in two phases.  Half the
  36.      boards are flashed in the first phase and half in the second.  Using
  37.      options, it is possible to flash a subset of the boards.  Also, the user
  38.      can specify a different image directory and different image files.
  39.  
  40.      By default on OCTANE systems, the single system flash PROM is flashed
  41.      with the specified image.  On OCTANE systems, options specifying multiple
  42.      PROMs, types of PROMs, or PROM configuration values will be silently
  43.      ignored.
  44.  
  45.      OCTANE systems have an additional feature of storing information from
  46.      diagnostics in the flash PROM for extraction at a later time.  The ----LLLL
  47.      option invokes this processing, and transfers the extracted information
  48.      into syslog.  This processing will take place automatically during each
  49.      system boot.
  50.  
  51.      Unless forced, _f_l_a_s_h does not flash the PROM unless the specified version
  52.      is newer than what is currently in the PROM.  _f_l_a_s_h can also be used to
  53.      obtain information about the current PROMs.
  54.  
  55.      The options are:
  56.  
  57.      ----aaaa           Flash all PROMs at once, overriding the protection of
  58.                   flashing in two groups.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffllllaaaasssshhhh((((1111MMMM))))                                                            ffffllllaaaasssshhhh((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----cccc           Flash only the node (CPU) PROMs on the machine.  This option
  75.                   is ignored on the SGI Origin 3000 server series.
  76.  
  77.      ----dddd           Print out the PROM header information for the current PROMs.
  78.  
  79.      ----DDDD           Dump the entire contents of a PROM to a file.
  80.  
  81.      ----ffff           Specify different (than currently in PROM) configurations
  82.                   values to be used when the new images are flashed.  These
  83.                   values include the speed of the CPU, hub, and size of the
  84.                   cache.  This option should be used with great care as cause
  85.                   the machine to freeze and be rendered unusable if incorrect
  86.                   values are given.
  87.  
  88.      ----FFFF           Similar to ----ffff except more detailed information is required
  89.                   and no checking is done in the input values.  This is more
  90.                   dangerous the ----ffff option and the same cautions apply.
  91.  
  92.      ----iiii           Flash only the IO PROMs on the machine.  This option is
  93.                   ignored on the SGI Origin 3000 server series.
  94.  
  95.      ----mmmm _m_o_d_u_l_e__i_d Flash only PROMs in the module given by _m_o_d_u_l_e__i_d.  This
  96.                   option does not apply to the SGI Origin 3000 server series.
  97.  
  98.      ----bbbb _b_r_i_c_k__i_d  Flash only PROMs in the brick given by _b_r_i_c_k__i_d.  This
  99.                   option applies only to the SGI Origin 3000 server series.
  100.  
  101.      ----nnnn           Flash only the node (CPU) PROMs on the machine. This option
  102.                   is ignored on the SGI Origin 3000 server series.
  103.  
  104.      ----oooo           Override the version checking and flash the PROM even if it
  105.                   is not newer than what is currently on the PROM.
  106.  
  107.      ----pppp _d_i_r__n_a_m_e  Specify a directory other than the default of
  108.                   /_u_s_r/_c_p_u/_f_i_r_m_w_a_r_e to look for images.  Note that there are
  109.                   standard names that _f_l_a_s_h looks for and thus the files in
  110.                   this should follow the correct naming scheme.
  111.  
  112.      ----PPPP _i_m_g__n_a_m_e  Specify the full pathname of the image desired to be
  113.                   flashed.  The options specifying the type of PROM to be
  114.                   flashed should match the PROM specified in _i_m_g__n_a_m_e.
  115.  
  116.      ----ssss _s_l_o_t__n_a_m_e Flash only the PROMs in the slot given by _s_l_o_t__n_a_m_e.  This
  117.                   option does not apply to the SGI Origin 3000 server series.
  118.  
  119.      ----SSSS           Force all the flashes to occur sequentially (versus in two
  120.                   parallel phases).
  121.  
  122.      ----vvvv           Turn on verbose mode.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ffffllllaaaasssshhhh((((1111MMMM))))                                                            ffffllllaaaasssshhhh((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      ----VVVV           Print currently loaded flash PROM version and time flashed
  141.                   information.
  142.  
  143.      OCTANE specific options
  144.  
  145.      ----LLLL           Extract information logged into the flash PROM by
  146.                   diagnostics from the PROM and into syslog.
  147.  
  148. FFFFIIIILLLLEEEESSSS
  149.      /usr/cpu/firmware/io6prom.img      default file for flashing IO PROMs for
  150.                                         Origin
  151.      /usr/cpu/firmware/ip27prom.img     default file for flashing CPU PROMs
  152.                                         for Origin 2000 and Origin 200
  153.      /usr/cpu/firmware/ip35prom.img     default file for flashing CPU PROMs
  154.                                         for Origin 3000
  155.      /usr/cpu/firmware/IP30prom.bin     default file for flashing OCTANE PROMs
  156.  
  157. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  158.      The _f_l_a_s_h command is not intended for casual use.  If used incorrectly,
  159.      it can completely freeze a system and prevent it from even booting the
  160.      PROM.  Also, frequent flashing decreases the lifetime of the system's
  161.      boards.  Silicon Graphics strongly recommends that this command only be
  162.      used under the supervision of a support representative.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.