S6-INSTANCE-LIST(8)

NAME
s6-instance-list - give a list of all currently created instances of an instanced service

SYNOPSIS
s6-instance-list servicedir

DESCRIPTION
s6-instance-list expects a running, supervised s6-instanced-service(7) in servicedir, as well as an existing instance of this service named name.

It prints to stdout, one per line, the names of all existing instances of servicedir, i.e. the ones that have been created and not deleted. It does not matter if the instances are up or down; if they've been created and not deleted, they're printed.

It exits 0.

The list is unsorted, the instance names are printed in an unspecified order.

You can use s6-instance-list to script commands that handle sets of instances. For example, to get the status of all the instances of a given service, you could write: ‘for i in `s6-instance-list service`; do printf "%s: " $i; s6-instance-status service $i; done’

EXIT STATUS

0   Success.

100 Wrong usage.

111 System call failed.

SEE ALSO
s6-instanced-service(7), s6-instance-control(8), s6-instance-create(8), s6-instance-delete(8), s6-instance-maker(8), s6-instance-status(8)

AUTHORS
Laurent Bercot Alexis <flexibeast@gmail.com> (man page port)