CLI reference
Every flag for both binaries, with defaults. Flag names and defaults are public API — see versioning & scope.
rcfg-sim
Section titled “rcfg-sim”The SSH server. One instance per IP.
| Flag | Default | Description |
|---|---|---|
--listen-ip |
10.50.0.1 |
IP address to bind |
--port-start |
10000 |
First port in the contiguous range |
--port-count |
2500 |
Number of ports to bind |
--manifest |
/opt/rcfg-sim/manifest.csv |
Path to the generator manifest (authoritative port→config mapping) |
--host-key |
/etc/rcfg-sim/ssh_host_rsa_key |
Path to the SSH host key (generated if missing) |
--username |
admin |
Accepted SSH username (currently informational; auth is password-only) |
--password |
admin |
Accepted SSH password (empty = accept any) |
--enable-password |
enable123 |
Enable-mode password |
--ssh-auth |
password |
SSH transport auth: password (all devices) | driver (per-driver) | none (in-band only) |
--metrics-addr |
0.0.0.0:9100 |
Prometheus metrics + /healthz address (empty = disable) |
--response-delay-ms-min |
50 |
Minimum per-command response delay (ms) |
--response-delay-ms-max |
500 |
Maximum per-command response delay (ms) |
--fault-rate |
0.0 |
Probability [0,1] an enabled fault fires per event |
--fault-types |
"" |
Comma-separated faults: auth_fail, disconnect_mid, slow_response, malformed |
--max-concurrent-sessions |
5000 |
Semaphore cap on concurrent sessions |
--commands-root |
"" |
Directory of per-device command output files, DIR/<hostname>/<slug>.txt (empty = off). See Command files |
--log-level |
info |
error | warn | info | debug |
rcfg-sim-gen
Section titled “rcfg-sim-gen”The config generator. Run once per campaign.
| Flag | Default | Description |
|---|---|---|
--count |
50000 |
Number of device configs to generate |
--output-dir |
/opt/rcfg-sim/configs |
Directory for rendered .cfg files |
--manifest |
/opt/rcfg-sim/manifest.csv |
Output CSV manifest path |
--ip-base |
10.50.0.1 |
First IP alias |
--ip-count |
20 |
Number of IP aliases |
--port-start |
10000 |
First port in the range |
--devices-per-ip |
2500 |
Devices mapped to each IP |
--seed |
42 |
PRNG seed for deterministic output |
--distribution |
sm:40,md:40,lg:15,xl:5 |
Model weights (percent, sum 100). Models: sm, md, lg, xl, 2xl, 3xl, 4xl, 5xl, 6xl, ciena-6500-tl1, ciena-6500-tl1-gne, infinera-dtnx-tl1, cisco-ons15454-tl1 |
--username |
admin |
Username written into the manifest |
--password |
admin |
Password written into the manifest |
--enable-password |
enable123 |
Enable password written into the manifest |