Command-line tools¶
Installed tools vary by packaging method. Run each command with --help on the target build; this page describes the current roles rather than freezing every option.
smithproxy¶
The main process hosts proxy workers, policy evaluation, CLI and HTTP services.
smithproxy --help
smithproxy --config-check-only
Validate configuration before a service restart. Foreground execution is useful in a test namespace or container; use the packaged service definition for normal operation.
sx_ctl¶
Controls the installed Smithproxy instance:
sudo sx_ctl start
sudo sx_ctl stop
sudo sx_ctl status
Historical documentation described sx_ctl as supervising smithdog, smithd, SOAP and portal processes. Those legacy components are no longer part of the current core architecture.
sx_cli¶
Connects to the local interactive CLI, normally on TCP port 50000:
sudo sx_cli
See Interactive CLI.
sx_network¶
Applies or removes host traffic-diversion rules:
sudo sx_network start
sudo sx_network stop
Review /etc/smithproxy/smithproxy.startup.cfg before use. Network rules can interrupt connectivity; keep an out-of-band recovery path when changing a remote host.
sx_regencerts and sx_certinfo_ca¶
Generate and inspect the TLS signing CA:
sudo sx_regencerts
sudo sx_certinfo_ca
See Certificates. Never distribute the generated private key.
sx_download_ctlog¶
Downloads Certificate Transparency log keys used by CT validation. Verify the configured destination and refresh policy on the target release.