WIP: initial shell script to configure, build and profile using valgrind/callgrind

Author: marcandrecasavant

scripts/osx/README.md

@@ -50,3 +50,36 @@ The information below is for future reference.
 cp ./org.freeradius.radius.plist /Library/LaunchDaemons
 launchctl load -w Library/LaunchDaemons/org.freeradius.radiusd.plist
 ```
+
+Examples:
+
+Reconfigure + rebuild + profile in one run:
+```
+scripts/osx/profile-callgrind.sh \
+  --clean \
+  --cflags "-g3 -O1 -fno-omit-frame-pointer" \
+  --ldflags "-fno-omit-frame-pointer" \
+  --jobs 16 \
+  --run-seconds 60
+```
+
+Reconfigure + rebuild only (no profiling run):
+```
+scripts/osx/profile-callgrind.sh \
+  --clean \
+  --configure-only \
+  --cflags "-g3 -O1 -fno-omit-frame-pointer" \
+  --ldflags "-fno-omit-frame-pointer" \
+  --jobs 16
+```
+
+Confirm command history log was written:
+```
+ls -t build/callgrind/commands.radiusd.*.log | head -n 1
+```
+
+Inspect the newest log:
+```
+latest_log=$(ls -t build/callgrind/commands.radiusd.*.log | head -n 1)
+sed -n '1,200p' "$latest_log"
+```