.. _svc.action.common_object_actions.ls: :cmd:`om svc ls` ---------------- List the service names with a local instance. Most useful to test a service selector expression before running an action. :opt:`--color=` +++++++++++++++++++++++ Colorize output. Possible values are: * auto: guess based on tty presence * always|yes: always colorize * never|no: never colorize :opt:`--daemon` +++++++++++++++ A flag inhibiting the command daemonization. Set by the daemonization routine. :opt:`--debug` ++++++++++++++ Increase stream and file log verbosity up to the debug level. :opt:`--env` ++++++++++++ Export the uppercased variable in the os environment. With the create action only, set a env section parameter in the service configuration file. Multiple ``--env =`` can be specified. For all other actions. :opt:`--filter=` ++++++++++++++++++++++++ A JSONPath expression to filter a JSON output. :opt:`--format=` ++++++++++++++++++++++++ Specify a data formatter. Possible values are json, flat_json, csv or table. csv and table formatters are available only for commands returning tabular data. :opt:`--local` ++++++++++++++ Execute the service action on the local service instances only, ignoring cluster-wide considerations. :opt:`--namespace=` +++++++++++++++++++++++++++ The namespace to switch to for the action. Namespaces are cluster partitions. A default namespace can be set for the session setting the OSVC_NAMESPACE environment variable. :opt:`--node=` ++++++++++++++++++++++ The node to send a request to. If not specified the local node is targeted. :opt:`--status=` ++++++++++++++++++++++++ Operate only on service with a local instance in the specified availability status (up, down, warn, ...). :opt:`--waitlock=` ++++++++++++++++++++++++++ A duration expression like ``5s``. The maximum wait time when acquiring the service action lock. :opt:`-h, --help` +++++++++++++++++ Show this help message and exit. :opt:`-p, --parallel` +++++++++++++++++++++ Start actions on specified services in parallel. :kw:`max_parallel` in node.conf limits the number of parallel running subprocesses. :opt:`-s, VAL, --service=` ++++++++++++++++++++++++++++++++++ A service selector expression ``[!][[!]]`` where: - ``!`` is the expression negation operator - ```` can be: - ``,`` OR expressions - ``+`` AND expressions - ```` can be: - a shell glob on service names - ```` where: - ```` can be: - ``:`` - ``:`` - ``.`` - ``.`` - `` dictionary extended under the 'nodes' key by each instance 'status' and 'config' data>`` - ```` can be: - ``<`` ``>`` ``<=`` ``>=`` ``=`` - ``~`` the string or any list element matches the regexp value - ``~=`` the string matches regexp value or any list element is the value Examples: - ``*dns,ha*+app.timeout>1`` - ``ip:+task:`` - ``!*excluded`` - ``$.avail=warn`` - ``$.nodes.*.status.avail=warn`` Note: - ``!`` usage requires single quoting the expression to prevent shell history expansion