NAME

       initctl — Control tool for Finit

SYNOPSIS

       /sbin/initctl [-bcfhlpqtv] [COMMAND]

DESCRIPTION

       initctl  is the official tool for interacting with finit(8).  It comes with functions for showing status,
       querying health of services, as well as editing, enabling and disabling services.

OPTIONS

       This program follows the usual UNIX command line syntax, with  long  options  starting  with  two  dashes
       (`-').  The options are as follows:

       -b, --batch
               Batch mode, no screen size probing.

       -c, --create
               Create missing paths (and files) as needed.  Useful with the edit command.

       -f, --force
               Ignore missing files and arguments, never prompt.

       -h, --help
               Show built-in help text.

       -1, --once
               Only one lap in commands like top.

       -p, --plain
               Use plain table headings, no ANSI control characters.

       -q, --quiet
               Silent, only return status of command.

       -t, --no-heading
               Skip table headings.

       -v, --verbose
               Verbose output, where applicable.

COMMANDS

       initctl debug
               Toggle finit (daemon) debug to /dev/console

       initctl help
               Show built-in help text

       initctl version
               Show Finit (daemon) version

       initctl ls | list
               List all *.conf files in /etc/finit.d

       initctl create CONF
               Create .conf in /etc/finit.d/available

       initctl delete CONF
               Delete .conf in /etc/finit.d/available

       initctl show CONF
               Show .conf in /etc/finit.d/available

       initctl edit CONF
               Edit .conf in /etc/finit.d/available

       initctl touch CONF
               Change  (mark  as  modified)  .conf  in /etc/finit.d/available, like edit this tells finit that a
               configuration has been changed and is a candidate to  be  restarted  (or  SIGHUP'ed)  on  initctl
               reload

       initctl enable CONF
               Enable .conf in /etc/finit.d/available, i.e., add symlink in /etc/finit.d/enabled

       initctl disable CONF
               Disable .conf in /etc/finit.d/enabled, i.e., removes symlink

       initctl reload
               Reload *.conf in /etc/finit.d, i.e., activates changes

       initctl cond set COND
               Set (assert) user-defined condition, +usr/COND

       initctl cond clr | clear COND
               Clear (deassert) user-defined condition, -usr/COND

       initctl cond status
               Show condition status, default cond command.

       initctl cond dump
               Dump all conditions and their status

       initctl ident [NAME]
               Display indentities of all run/task/services, or only instances matching NAME.  A partial string,
               e.g., NAM, will not match anything

       initctl log [NAME]
               Show ten last Finit, or NAME, messages from syslog

       initctl start NAME[:ID]
               Start service by name, with optional ID, e.g., initctl start tty:1

       initctl stop NAME[:ID]
               Stop/Pause a running service by name

       initctl reload NAME[:ID]
               Reload service by name (SIGHUP or restart)

       initctl restart NAME[:ID]
               Restart (stop/start) service by name

       initctl status NAME[:ID]
               Show  service  status, by name.  If only NAME is given and multiple instances exits, a summary of
               all matching instances are shown.  Only an  exact  match  displays  the  detailed  status  for  a
               particular instance

       initctl status
               Show status of all services, default command

       initctl cgroup
               List cgroup config overview

       initctl ps
               List processes based on cgroups

       initctl top
               Show top-like listing based on cgroups

       initctl runlevel [0-9]
               Show or set runlevel: 0 halt, 6 reboot

       initctl reboot
               Reboot system, default if reboot is symlinked to initctl

       initctl halt
               Halt system, default if halt is symlinked to initctl

       initctl poweroff
               Power-off system, default if poweroff is symlinked to initctl

       initctl suspend
               Suspend system, default if suspend is symlinked to initctl

       initctl utmp show
               Raw dump of UTMP/WTMP db

SEE ALSO

       finit.conf(5) finit(8)

AUTHORS

       finit  was  conceived  and  reverse  engineered  by  Claudio Matsuoka.  Since v1.0, maintained by Joachim
       Wiberg, with contributions by many others.

Linux                                             June 6, 2021                                        INITCTL(8)