Index: dtrace/README =================================================================== diff -u -rc4f449cb353be812ba6502ef8e9587e87881f59b -ree6699cdfbf3ad89cccfa9d52dd23767d13f9d73 --- dtrace/README (.../README) (revision c4f449cb353be812ba6502ef8e9587e87881f59b) +++ dtrace/README (.../README) (revision ee6699cdfbf3ad89cccfa9d52dd23767d13f9d73) @@ -1,24 +1,37 @@ DTrace provider for the Next Scripting Language This is an implementation of a DTrace provider for the Next Scripting -Language (nsf). The nsf provider is designed to be used with and -without the DTrace support for Tcl. Therefore, nsf can be configured +Language (NSF). The NSF provider is designed to be used with and +without the DTrace support for Tcl. Therefore, NSF can be configured with --with-dtrace also in cases where Tcl was compiled without it. -To enable DTrace, run configure with the flag --enable-dtrace. The -DTrace support for nsf was developed under Mac OS X, other platforms -might require some fine tuning to get it running. Please report -improvements back to the nsf developers. +To enable DTrace, run configure with the flag --with-dtrace configure +flag. The DTrace support for NSF was developed under Mac OS X, other +platforms might require some fine tuning to get it running. Please +report improvements back to the NSF developers. -Once DTrace support is compiled into nsf, one can run D scripts like -in the following example: +In Mac OS X version including System Integrity Protection (SIP), one +must deactivate SIP for DTrace, first: - sudo dtrace -q -F -s dtrace/timestamps.d -c "./nxsh tests/object-system.test" +1) Boot into Recovery OS +2) Open Terminal +3) Run: "csrutil disable" +4) Run: "csrutil enable --without dtrace" -DTrace requires normally that dtrace is run with root permissions. In -case the provided sample scrips in the dtrace directory don't work the -following hints might help: +Once SIP has been disarmed, and once DTrace support is compiled into +NSF, one can run D scripts like so: +1) (Terminal window 1): sudo dtrace -q -F -s dtrace/timestamps.d -W tclsh +2) (Terminal window 2): tclsh dtrace/sample.tcl + +(Note: The "dtrace -c" option, as shown below, is not operative unless +SIP is fully disabled: Run "csrutil disable" only, omit the fourth +step.) + +DTrace requires normally that the dtrace command is run with root +permissions. In case the provided sample scrips in the dtrace +directory don't work out of the box, the following hints might help: + * Make sure that a "package require nx" works for root as well (install nx, or provide a TCLLIBPATH, etc.). You might want to add e.g. the following line