Debugging IOGraphics

---------------------------------------------------------------------------------------------------------------------------

Tool                  : KDEBUG Tracing
Introduction OS       : Lobo/10.13
Requires Special Build: No
Notes                 : See IOGraphicsTypesPrivate.h DBG_IOG_... definition comments for code and parameter details
Instructions          : 

Initialize Tracing:
	sudo trace -i
Start Recording Events:
	sudo trace -e -c 5 -s 50
Stop Recording:
	sudo trace -d
Dump Trace:
	stdout: sudo trace -t
	rawout: sudo trace -l FILENAME
Terminate Tracing:
	sudo trace -r

---------------------------------------------------------------------------------------------------------------------------

Tool                  : Ariadne Tracing
Introduction OS       : Lobo/10.13
Requires Special Build: Yes
Notes                 : Definitions in IOGraphicsKTrace.h, Ariadne sign posts in IOGraphicsSignPosts.plist
Instructions          : 

Enable tracing:
	Build with ENABLE_TELEMENTRY = 1.
Load Custom Sign Posts:
	Include IOGraphicsSignPosts.plist in Ariadne custom sign posts (preferences).
Start Recording Events:
	sudo artrace
Stop Recording:
	CTRL-C
Viewing Trace:
	Load trace in Ariadne application.

---------------------------------------------------------------------------------------------------------------------------

Tool                  : DTrace Tracing
Introduction OS       : Fuji/10.12
Requires Special Build: No
Notes                 : 
Instructions          : 

Enable Private Probes:
	sudo sysctl kern.dtrace.provide_private_probes=1
Start Recording Events:
	Run desired IOGraphics .trace script from Terminal.
Stop Recording:
	CTRL-C for terminal

---------------------------------------------------------------------------------------------------------------------------

Tool                  : kprintf/IOLog logging
Introduction OS       : Pre-Fuji
Requires Special Build: Yes
Notes                 : Logging Macros and Enablers in IOGraphicsPrivate.h (DEBG, DEBG1, DEBG2)
Instructions          : 

View Logs Via:
	standard system logs
	serial logging

---------------------------------------------------------------------------------------------------------------------------

Tool                  : Instruments Application
Introduction OS       : Fuji/10.12
Requires Special Build: No
Notes                 : 
Instructions          : Load Instruments, select Custom Template, navigate to and load IOGraphics.instruments

---------------------------------------------------------------------------------------------------------------------------