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.