66

Software

obarun.org

66

Program to control the state of the system and service manager.

Interface

66 [ -h ] [ -z ] [ -v verbosity ] [ -l live ] [ -T timeout ] [ -t tree ] start|stop|reload|restart|free|reconfigure|enable|disable|configure|status|resolve|state|remove|signal|tree|parse|scandir|boot|poweroff|reboot|halt|version [<command options> or subcommand <subcommand options>] service...|tree

Invocation of 66 can be made as root or regular account.

Options

These options are available all commands except the -t options. In such cases, the help of the specific command provides clarification.

• -h: prints this help.

• -z: use color.

• -v verbosity: increases/decreases the verbosity of the command.

  • 0: only print error messages.
  • 1: also, print informative messages. This is the default.
  • 2: also, print warning messages.
  • 3: also, print tracing messages.
  • 4: also, print function name and line code of the messages.
  • 5: also, display the sequence of the current process function by function.

• -l live: changes the supervision directory of service to live. By default this will be /run/66. The default can also be changed at compile time by passing the --livedir= option to ./configure. An existing absolute path is expected and should be within a writable and executable filesystem - likely a RAM filesystem—see scandir command.

• -T timeout: specifies a general timeout (in milliseconds) passed to command. By default the timeout is set to 0 (infinite).

• -t tree: set tree as tree to use.

Commands

User command

• start: bring up services.
• stop: bring down services.
• enable: activate services for the next boot.
• disable: deactivate services for the next boot.
• reload: send a SIGHUP signal to services.
• restart: bring down then bring up services.
• status: display service information.
• configure: manage service environment variables.
• reconfigure: bring down, unsupervise, parse it again and bring up service.
• remove: remove service and cleanup all files belong to it within the system.
• free: bring down services and remove it from scandir.
• tree: manage or see information of trees.
• poweroff: poweroff the system.
• reboot: reboot the system.
• halt: halt the system.
• version: display 66 version.

Admin command

• boot: boot the system.
• scandir: manage scandir.
• signal: send a signal to services.

Debug command

• parse: parse the service frontend file.
• resolve: display the service’s resolve file contents.
• state: display service’s state file contents.

Exit codes

• 0 success
• 100 wrong usage
• 111 system call failed

Furthermore, all commands receive the same exit code.

Instanced service

An instanced service name from a service template can be passed as service argument where the name of the service must end with a @ (commercial at).—see frontend service file.

(!) The name of the template must be declared first immediately followed by the instance name.

For example, to enable a intanced service, you can do:

66 enable foo@foobar

Handling dependencies

Any dependency or required-by dependency of a service or a tree chain will be automatically resolved. Manually defining chains of interdependencies is unnecessary.

For instance, during the stop command, if the FooA service has a declared required-by dependency on FooB, FooB will be considered and automatically stopped first when FooA is stopped. This process will run recursively until all required-by dependencies are stopped. This is also valuable for the opposite process, meaning start.

This applies to all 66 commands when it’s necessary.