.. _list:


Get list of watchers or processes in a watcher
==============================================

ZMQ Message
-----------


To get the list of all the watchers::

    {
        "command": "list",
    }


To get the list of processes in a watcher::

    {
        "command": "list",
        "properties": {
            "name": "nameofwatcher",
        }
    }


The response return the list asked. Flies returned are process ID
that can be used in others commands.

Command line
------------

::

    $ circusctl list [<name>]