SolarOS 4.6.8 manual · job

Background jobs

Jobs are named background workers such as logging, acquisition, bridges, NTP, and HTTP serving. They are not foreground applications and continue when you switch shell or app sessions.

Inspect memory and ownership

Run jobs for the compact overview and job status NAME for details:

jobs
job status log

The status includes the worker stack size and whether it uses internal RAM or PSRAM. Detailed status also shows the current start-admission disposition and reason using the same centralized policy that launches jobs. It shows claimed resources and the last error. Check mem before starting several internal-stack jobs together.

Waiting and failed

waiting means the requested worker has not passed launch admission yet. It may run later when the required memory or resource becomes available.

failed means launch or runtime work ended with an error. Inspect last_error and the resource owner before retrying.

Start and stop

job start batmon 60
job start log file /logs/system.log info
job stop log

Only one instance of each registered job name is active. Starting it again replaces the previous invocation.

Quick reference

solaros.jobs provides list(), count(), status(name), start(name, optional_args), and stop(name). Status includes state, last_error, worker_stack_bytes, worker_stack_external, tick timing, and deadline telemetry. The shell's detailed status adds the current start-admission disposition and reason. Waiting means launch admission has not yet succeeded; failed records a terminal launch or runtime error.