tiup list
The command tiup list
is used to get the list of available components of a mirror.
Syntax
tiup list [component] [flags]
[component]
is an optional parameter used to specify a certain component. If [component]
is set, TiUP lists all versions of the specified component; if not, TiUP lists all components.
Options
--all
- Displays all components. By default, TiUP does not show hidden components.
- Data type:
BOOLEAN
- This option is disabled by default and its default value is
false
. To enable this option, you can add this option to the command, and pass thetrue
value or do not pass any value.
--installed
- Only displays components and versions that have been installed.
- Data type:
BOOLEAN
- This option is disabled by default and its default value is
false
. To enable this option, you can add this option to the command, and pass thetrue
value or do not pass any value.
--verbose
- Displays installed component versions in the components list.
- Data type:
BOOLEAN
- This option is disabled by default and its default value is
false
. To enable this option, you can add this option to the command, and pass thetrue
value or do not pass any value.
Outputs
- If
[component]
is not set:- If
--verbose
is specified: TiUP outputs a component information list consisting ofName
(component name),Installed
(installed versions),Owner
(component owner), andDescription
(component description). - If
--verbose
is not specified: TiUP outputs a component information list consisting ofName
(component name),Owner
(component owner), andDescription
(component description).
- If
- If
[component]
is set:- If the specified component exists: TiUP outputs a version information list of the specified component, consisting of
Version
(version number),Installed
(installation status),Release
(release date), andPlatforms
(supported platforms). - If the specified component does not exist: TiUP reports the error
failed to fetch component: unknown component
.
- If the specified component exists: TiUP outputs a version information list of the specified component, consisting of