olsg(1)

NAME
     olsg - online Scalable Graphics diagnostic

SYNOPSIS
     olsg
          [-sg2-config-info]
          [-sg2-discover-test]
          [-sg2-seq-pio]
          [-sg2-seq-int]
          [-sg2-dump-regs]
          [-sg2-sys-pio]
          [-is1-config-info]
          [-is1-seq-pio]
          [-is1-pll-test]
          [-setconfig]
          [-fill]
          [-polymode_cc4]
          [-su_cull_face]
          [-zb_aa_com2_Z24]
          [-zb_aa_com6_Z24]
          [-zb_tile_mm_Z24]
          [-zb_stenop_Z24]
          [-zb_strmaskZ24]
          [-zb_stmaskZ24]
          [-zb_stfuncZ24]
          [-zb_zbuffer_Z24]
          [-cb_aa_res2gm10]
          [-cb_aa_res6gm10]
          [-cb_channelmask]
          [-cb_tile_mm1555]
          [-mem_stress_tx]
          [-memst_tx_limit]
          [-surf_al16mpeg]
          [-surf_a2rgb10_s]
          [-surf_argb8_s]
          [-surf_l32f]
          [-surf_r11g11b10]
          [-surf_argb32f_m]
          [-onetri_top]
          [-lines_v_top]
          [-lines_c_16_top]
          [-tf_fmt_al16_s]
          [-tf_fmt_rg11b10]
          [-tf_fmt_rgb10a2]
          [-tf_mag_10s]
          [-tf_mag_16s]
          [-quad_s]
          [-quad_cmhitz_s]
          [-quad_anis1_cmz]
          [-quad_anis8_cmz]
          [-quadinquad_cmz]
          [-2quad_alwaysz]
          [-2quad_cmhitz]
          [-2quad_blendcmz]
          [-2quad_bl_cmhiz]
          [-2quad_anis1cmz]
          [-2quad_anis8cmz]
          [-wheelinwheel]
          [-2lev_tex5_cmz]
          [-2lev_tex5_lodb]
          [-donut8_cmhitz]
          [-donut16_blend]
          [-donut16_levtx2]
          [-donut16_levtx4]
          [-donut16_levtx7]
          [-donut8_blend]

          olsg incorporates the oldiags-ui. See oldiags-ui(1) for
          additional command line options.


AVAILABILITY
     SN-MIPS systems with CG or CGN brick


DESCRIPTION
   Overview
     By default, olsg discovers and displays the configuration of the system
     under test, performs a PIO test to each of the discovered SG2 graphics
     cards in sequence, performs a PIO test to all discovered SG2 graphics
     cards in parallel, verifies that an interrupt can be issued by the SG2
     graphics card and processed by the host system.  If present, a PIO test
     will be performed on any ImageSync1 (IS1) boards. It performs more than
     40 tests on all AGP Pro50 cards in the system in sequence, in order to
     test the correct functionality of the cards from the graphics point of
     view. Simulteanously, through these tests, other errors on the system may
     be revealed (AGP slot, system software, timing e.t.c)



   Command Line Options
     -v | -vertex agp_device_vertex
          Optional. If present, will perform tests on the specified
          agp_device_vertex.  If not present, olsg will operate on all
          available SG2 and IS1 cards.

     -system

     -probe
          Discovers the system type, brick types and presence of graphics
          hardware. This routine is used internally for diagnostic setup and
          provides little information for the user.

     -sg2-config
          Dumps PCI config space of specified SG2 cards. This section may be
          useful for reading the PCI configuration space of the SG2 cards in
          question.


     -sg2-discover
          The SG2 Discovery library test section is used mostly by the other
          test sections when determining the set of SG2 cards to be tested. It
          is also useful for the user in order to see the number and location
          of CPUs, bricks, SG2 cards and IS1 cards.


     -sg2-seq-pio
          SG2 Sequential PIO transfers test the PIO mechanism using several
          scratch registers. Data patterns such as walking 1's, walking 0's,
          addressing, checkerboard, and random patterns are employed. Each
          card is tested individually until all SG2 cards are tested.


     -sg2-sys-pio
          SG2 System PIO transfers test the PIO mechanism in a similar manner,
          except all cards are tested in parallel. If the card resides in a
          CGN brick, a CPU in the brick will be assigned to test that card.


     -sg2-seq-int
          SG2 Sequential interrupt issue verifies that the SG2 card can
          generate a generic software interrupt that is seen and processed by
          the host system.


     -is1-config-info
          IS1 Configuration Space dump displays the PCI config space of the
          IS1 card. The revision of the logic used in the IS1 card is stored
          in the RevID field of the configuration space.


     -is1-seq-pio
          IS1 Sequential PIO tests the PIO mechanism using several IS1
          registers.  Data patterns such as walking 1's, walking 0's,
          addressing, checkerboard, and random patterns are employed. Each
          card is tested individually until all IS1 cards are tested.  Note
          that this test will leave data in registers that will not allow the
          IS1 to operate correctly. The XFree86 server will need to be
          restarted in order to reload the correct values.


     -is1-pll-test
          The IS1 PLL test verifies that the connection between the primary
          IS1 logic and the PLL is functioning correctly, displays the chip
          revision and verifies the integrity of the PLL registers. Note that
          this test will leave data in registers that will not allow the IS1
          to operate correctly.  The XFree86 server will need to be restarted
          in order to reload the correct values.


     -setconfig
          Load video mode.


     -fill
          Exhaustive memory cell test.


     -polymode_cc4
          Multiple graphics primitive [points, lines, triangles] test.


     -su_cull_face
          Iterates through different combinations of primitives, face
          direction and culling.

     -zb_aa_com2_Z24
          24-bit Z-buffer block compression test, 2 anti-aliasing samples.


     -zb_aa_com6_Z24
          24-bit Z-buffer block compression test, 2 anti-aliasing samples.


     -zb_tile_mm_Z24
          24-bit Z-buffer tiling macrotiled-microtiled.


     -zb_stenop_Z24
          24-bit Z-buffer stencil operations.


     -zb_strmaskZ24
          24-bit Z-buffer stencil replace mask.


     -zb_stmaskZ24
          24-bit Z-buffer stencil mask.


     -zb_stfuncZ24
          24-bit Z-buffer stencil functions.


     -zb_zbuffer_Z24
          24-bit Z-buffering operations.

     -cb_aa_res2gm10
          color buffer, 2-sample anti-aliasing resolve, 10-bit gamma.


     -cb_aa_res6gm10
          color buffer, 6-sample anti-aliasing resolve, 10-bit gamma.


     -cb_channelmask
          color buffer channel mask.


     -cb_tile_mm1555
          color buffer tiling, macrotiled-microtiled, ARGB1555.


     -mem_stress_tx
          test all component sizes (signed and unsigned) under extreme
          maginfication using a linear filter.


     -memst_tx_limit
          mem_stress_tx with 1/16 cache size.


     -surf_al16mpeg
          surface format, 512x256 alpha-luminance texture.


     -surf_a2rgb10_s
          surface format, 64x64 RGBA2101010 signed texture.


     -surf_argb8_s
          surface format, 32x32 ARGB8888 signed texture.


     -surf_l32f
          surface format, 512x256 alpha-luminance texture.


     -surf_r11g11b10
          surface format, 80x64 RGB111110 texture.


     -surf_argb32f_m
          surface format, 51x512 ARGB32F texture.


     -onetri_top
          single triangle primitive multi-shader op.

     -lines_v_top
          line primitives, width 10, line end vertical


     -lines_c_16_top
          line primitives, width 10, line end computed, 16 subpixels


     -tf_fmt_al16_s
          Texture Formats test (AL16).


     -tf_fmt_rg11b10
          Texture Formats test (R11G11B10).


     -tf_fmt_rgb10a2
          Texture Formats test (RGB10A20.


     -tf_mag_10s
          Tests all component sizes (signed and unsigned) under extreme
          magnification using a linear filter (csize 10).


     -tf_mag_16s
          Tests all component sizes (signed and unsigned) under extreme
          magnification using a linear filter (csize 16).


     -quad_s
          PPS Shader Performance test.

     -quad_cmhitz_s
          PPS Shader Performance test.

     -quad_anis1_cmz
          PPS Shader Performance test.

     -quad_anis8_cmz
          PPS Shader Performance test.

     -quadinquad_cmz
          PPS Shader Performance test.

     -2quad_alwaysz
          PPS Shader Performance test.

     -2quad_cmhitz
          PPS Shader Performance test.

     -2quad_blendcmz
          PPS Shader Performance test.

     -2quad_bl_cmhiz
          PPS Shader Performance test.

     -2quad_anis1cmz
          PPS Shader Performance test.

     -2quad_anis8cmz
          PPS Shader Performance test.

     -wheelinwheel
          PPS Shader Performance test.

     -2lev_tex5_cmz
          PPS Shader Performance test.

     -2lev_tex5_lodb
          PPS Shader Performance test.  TP -donut8_cmhitz PPS Shader
          Performance test.

     -donut16_blend
          PPS Shader Performance test.

     -donut16_levtx2
          PPS Shader Performance test.

     -donut16_levtx4
          PPS Shader Performance test.

     -donut16_levtx7
          PPS Shader Performance test.

     -donut8_blend
          PPS Shader Performance test.



EXAMPLES
     olsg        When run without options, the discovery code will be run,
                followed by the sg2-seq-pio test, the sg2-seq-int test, and
                the sg2-sys-pio test. Subsequently, all the fuctionality tests
                will follow.


     olsg -v /hw/module/001c02/CGbrick/xtalk/11/agp/1/1a -sg2-seq-pio

                Runs the Sequential PIO test only on the SG2 card on Bus 1
                Slot 1 as listed in the hardware graph.

NOTES
   General
     olsg does not require the kernel driver to be loaded.  It should,
     however, run if the kernel driver is loaded and the XFree86 server is
     off.  It is not a good idea to run a test section on an inappropriate
     card. In other words, don't try running an IS1 test on a vertex that
     contains an SG2 card.


   Concurrency
     It is not recommended to run olsg concurrently with user jobs. If the
     XFree86 server was up, even if it is now stopped, errors will appear. So,
     reset the machine in clean state, having the XFree86 server off.


DIAGNOSTICS
     Upon successful completion olsg returns 0. If a program (software) error
     occurs, a 1 is returned. If a hardware error is detected olsg returns a
     2.


FILES
     /usr/diags/SG/bin/olsg


SEE ALSO
     oldiag-ui(1), olsgsys(1), bridgeloc(1), hwgraph(4)