WIP: moved profile-callgrind.sh to scripts/profiling

Author: marcandrecasavant

scripts/osx/README.md

@@ -50,113 +50,3 @@ 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
-```
-
-Configure and build, no profiling run
-```
-scripts/osx/profile-callgrind.sh \
-  --clean \
-  --build-only \
-  --cflags "-g3 -O1 -fno-omit-frame-pointer" \
-  --ldflags "-fno-omit-frame-pointer" \
-  --jobs 16
-```
-
-Build first, then run profiling as a separate step:
-```
-scripts/osx/profile-callgrind.sh \
-  --clean \
-  --build-only \
-  --cflags "-g3 -O1 -fno-omit-frame-pointer" \
-  --ldflags "-fno-omit-frame-pointer" \
-  --jobs 16
-
-scripts/osx/profile-callgrind.sh \
-  --profile-only \
-  --env-file build/tests/multi-server/prof-accept/short_ci/freeradius/profiling-server/proto_load_config.env \
-  --reset-radiusd-args \
-  --radiusd-arg -f \
-  --radiusd-arg -m \
-  --radiusd-arg -l \
-  --radiusd-arg stdout \
-  --radiusd-conf-file raddb/radiusd.conf \
-  --run-seconds 60
-```
-
-Profile-only run using an explicit env file:
-```
-scripts/osx/profile-callgrind.sh \
-  --profile-only \
-  --env-file build/tests/multi-server/prof-accept/short_ci/freeradius/profiling-server/proto_load_config.env \
-  --reset-radiusd-args \
-  --radiusd-arg -f \
-  --radiusd-arg -m \
-  --radiusd-arg -l \
-  --radiusd-arg stdout \
-  --radiusd-conf-file raddb/radiusd.conf \
-  --run-seconds 60
-```
-
-Profile-only run using the auto-detected default env file:
-```
-scripts/osx/profile-callgrind.sh \
-  --profile-only \
-  --reset-radiusd-args \
-  --radiusd-arg -f \
-  --radiusd-arg -m \
-  --radiusd-arg -l \
-  --radiusd-arg stdout \
-  --radiusd-conf-file raddb/radiusd.conf \
-  --run-seconds 60
-```
-
-The `--env-file` argument is optional. If you omit it, `profile-callgrind.sh` automatically sources `build/tests/multi-server/prof-accept/short_ci/freeradius/profiling-server/proto_load_config.env` when that file exists.
-
-Argument reference for the profile-only command:
-
-- `--profile-only` skips configure and build steps and only runs the profiling phase.
-- `--env-file <path>` sources an environment file before starting `radiusd`. This is mainly used to export `TEST_LOADGEN_*` variables for the `listen load` section in `raddb/radiusd.conf`.
-- `--reset-radiusd-args` clears the script's default `radiusd` arguments before any later `--radiusd-arg` values are appended.
-- `--radiusd-arg -f` keeps `radiusd` in the foreground so valgrind can monitor the live server process directly.
-- `--radiusd-arg -m` enables the runtime behavior you were already using in the wrapper-based runs. If you omit it after `--reset-radiusd-args`, it will not be added automatically.
-- `--radiusd-arg -l` and `--radiusd-arg stdout` send server log output to standard output.
-- `--radiusd-conf-file raddb/radiusd.conf` appends `-d <confdir> -n <name>` for that config file. In this case it tells `radiusd` to use the repository's `raddb/radiusd.conf` profile.
-- `--run-seconds 60` runs the callgrind session for 60 seconds, then stops the profiled valgrind processes and writes the final callgrind output.
-
-Behavior notes:
-
-- The script launches the `scripts/bin/radiusd` wrapper by default, not `build/bin/local/radiusd` directly.
-- The wrapper supplies the repository-local dictionary and library setup, while the profile script adds your extra `radiusd` flags on top.
-- dSYM generation is enabled by default. Use `--no-dsym` to skip all dSYM generation, or `--no-dsym-modules` to keep the main binary dSYM but skip module dSYMs.
-
-Reconfigure (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"
-```