QNX System Analysis Toolkit (SAT)

Release Notes

Date of this edition: October 02, 2001

QNX RTOS version: compatible with RTP 6.1.0A or greater

Contents

What is the SAT?

The QNX System Analysis Toolkit (SAT), which includes an instrumented kernel, allows you to see further into running systems than ever before. The SAT allows developers to log every communication and state change within the kernel, including interrupts, parameters and return values from kernel calls, and scheduling decisions.

The SAT enables a deeper and more detailed analysis of network elements, allowing you to more easily optimize and debug every part of a system. With this tool, you can even perform kernel diagnostics remotely.

For more information, see the online docs (/usr/help/product/instr_en/bookset.html).

Running the instrumented kernel

To verify that you're running the instrumented kernel:

  1. Modify your buildfile to contain procnto-instr rather than procnto.

    For example (from /boot/build/qnxbasedma.build):

    # LD_LIBRARY_PATH is the *safe* path for libraries
    # (confstr(_CS_LIBPATH)) i.e. This is the path searched
    # for libs in setuid/setgid executables.
    
    PATH=/proc/boot:/bin:/usr/bin
    LD_LIBRARY_PATH=/proc/boot:/lib:/usr/lib:/lib/dll procnto
    
    # LD_LIBRARY_PATH is the *safe* path for libraries
    # (confstr(_CS_LIBPATH)) i.e. This is the path searched
    # for libs in setuid/setgid executables.
    
    PATH=/proc/boot:/bin:/usr/bin
    LD_LIBRARY_PATH=/proc/boot:/lib:/usr/lib:/lib/dll procnto-instr

  2. Run mkifs (as root) to generate the boot file from the buildfile. Remember to back up the original first:
    cp /.altboot /.altboot-preinstr
    mkifs /boot/build/qnxbasedma.build /.altboot

  3. Reboot your machine using the alternate boot file (press Esc when asked) and verify that you're now running the instrumented kernel:
    ls /proc/boot | grep instr

Known issues