Command Line
Detent installs three programs.
| Program | Role |
|---|---|
detent | Read a knob from the shell, auto-starting the user agent when needed |
detent-agent | The host-local agent daemon |
detent-authority | The durable authority daemon |
Shared Conventions
Section titled “Shared Conventions”- Precedence. Command-line flags override environment variables, which override configuration-file values, which override built-in defaults.
- Configuration files.
agent.jsonanddetent-authority.jsonlive in the platform’s Detent config directory;--config PATHselects one explicitly. Relative paths inside a config file are resolved against the file’s directory. See Configuration. - Foreground by default. Both daemons run in the foreground, which is what
service managers want.
--daemonizebackgrounds a user instance and reports readiness or the startup error to the caller. --statusis read-only. It reports what’s running and never starts anything.--systemselects system-wide configuration and runtime locations, and stopsdetent getfrom ever starting a private agent.- Stopping. Send SIGTERM to an unmanaged daemon; supervised services are stopped and restarted through the service manager.
Logging Flags
Section titled “Logging Flags”Both daemons accept the same logging flags:
| Flag | Effect |
|---|---|
--log-level LEVEL | emergency, alert, critical, error, warning, notice, info (default) or debug |
-v, -vv | Raise verbosity one or two steps |
--verbosity 0..2 | Same as repeating -v |
--color auto|always|never | Terminal colors; auto honors NO_COLOR and redirection |
--no-color | Same as --color never |
See Logging.