172/461

## list-domains

lists the domains in the specified directory

Synopsis

    list-domains [--help] [--domaindir domaindir]

Description

The `list-domains` subcommand lists the domains in the specified domains directory. If the domains directory is not specified, the domains in the default directory are listed. If there is more that one domains directory, the `--domaindir` option must be specified. The status of each domain is included.

This subcommand is supported in local mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--domaindir`

  The directory where the domains are to be listed. If specified, the path must be accessible in the files stem. If not specified, the domains in the domain root directory are listed. The default location of the domain root directory is as-install`/domains`.

Examples

Example 1 Listing Domains

  This example lists the domains in the default directory.

      asadmin> list-domains
      Name: domain1 Status: Running
      Name: domain2 Status: Not running
      Name: domain4 Status: Running, restart required to apply configuration changes
      Command list-domains executed successfully

Exit Status

0

  subcommand executed successfully

1

  error in executing the subcommand

See Also

create-domain(1), delete-domain(1), start-domain(1), stop-domain(1),

asadmin(1M)