Chapter 6. feature
6.1. feature:export-bundles
6.1.1. Description
Export all of the bundles that make up a specified feature to a directory on the file system.
6.1.2. Syntax
feature:export-bundles [options] featureName exportLocation
6.1.3. Arguments
| Name | Description |
|---|---|
| featureName | The name of the feature you want to export bundles for |
| exportLocation | Where you want to export the bundles |
6.1.4. Options
| Name | Description |
|---|---|
| -d, --dependencies-only | This flag indicates that only bundles marked as a dependency will be exported. |
| --help | Display this help message |
| -v, --version | The version of the feature you want to export bundles for. Default is latest |
6.2. feature:info
6.2.1. Description
Shows information about selected feature.
6.2.2. Syntax
feature:info [options] name [version]
6.2.3. Arguments
| Name | Description |
|---|---|
| name | The name of the feature |
| version | The version of the feature |
6.2.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| -d, --dependency | Display dependencies info |
| -b, --bundle | Display bundles info |
| -t, --tree | Display feature tree |
| -c, --configuration | Display configuration info |
| -x, --xml | Display feature xml |
| --conditional | Display conditional info |
| --color | Colorize output (`always', `never' or `auto') |
6.3. feature:install
6.3.1. Description
Installs a feature with the specified name and version.
6.3.2. Syntax
feature:install [options] features
6.3.3. Arguments
| Name | Description |
|---|---|
| features | The name and version of the features to install. A feature id looks like name/version. The version is optional. |
6.3.4. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --features-wiring | Print the wiring between features |
| --help | Display this help message |
| -v, --verbose | Explain what is being done |
| --all-wiring | Print the full wiring |
| --store | Store the resolution into the given file and result for offline analysis |
| -u, --upgrade | Perform an upgrade of feature if previous version are installed or install it |
| -r, --no-auto-refresh | Do not automatically refresh bundles |
| -s, --no-auto-start | Do not start the bundles |
| -m, --no-auto-manage | Do not automatically manage bundles |
| -g, --region | Region to install to |
6.4. feature:list
6.4.1. Description
Lists all existing features available from the defined repositories.
6.4.2. Syntax
feature:list [options]
6.4.3. Options
| Name | Description |
|---|---|
| -i, --installed | Display a list of all installed features only |
| -s, --show-hidden | Display hidden features |
| --help | Display this help message |
| -o, --ordered | Display a list using alphabetical order |
| -b, --show-blacklisted | Display blacklisted features |
| -r, --required | Display a list of all required features only |
| --no-format | Disable table rendered output |
6.5. feature:regions
6.5.1. Description
Prints information about region digraph.
6.5.2. Syntax
feature:regions [options] [regions]
6.5.3. Arguments
| Name | Description |
|---|---|
| regions | Regions to provide detailed info for. |
6.5.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| -n, --namespaces | Show namespaces in each filter. |
| -f, --filters | Show filters. |
| -v, --verbose | Show all info. |
| -b, --bundles | Show bundles in each region. |
6.6. feature:refresh
6.6.1. Description
Reloads features processing instructions and reprovisions existing features.
6.6.2. Syntax
feature:refresh [options]
6.6.3. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --features-wiring | Print the wiring between features |
| --help | Display this help message |
| -v, --verbose | Explain what is being done |
| --all-wiring | Print the full wiring |
6.7. feature:repo-add
6.7.1. Description
Add a features repository
6.7.2. Syntax
feature:repo-add [options] name/url [version]
6.7.3. Arguments
| Name | Description |
|---|---|
| name/url | Shortcut name of the features repository or the full URL |
| version | The version of the features repository if using features repository name as first argument. It should be empty if using the URL |
6.7.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| -i, --install | Install all features contained in the features repository |
6.8. feature:repo-list
6.8.1. Description
Displays a list of all defined repositories.
6.8.2. Syntax
feature:repo-list [options]
6.8.3. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| -r | Reload all feature urls |
| -b, --show-blacklisted | Also display blacklisted repositories |
| --no-format | Disable table rendered output |
6.9. feature:repo-refresh
6.9.1. Description
Refresh a features repository
6.9.2. Syntax
feature:repo-refresh [options] [repository] [Feature version]
6.9.3. Arguments
| Name | Description |
|---|---|
| repository | Shortcut name of the feature repository or the full URI |
| Feature version | The version of the feature if using the feature name. Should be empty if using the uri |
6.9.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
6.10. feature:repo-remove
6.10.1. Description
Removes the specified repository features service.
6.10.2. Syntax
feature:repo-remove [options] repository [Feature version]
6.10.3. Arguments
| Name | Description |
|---|---|
| repository | Shortcut name of the feature repository or the full URI |
| Feature version | The version of the feature if using the feature name. Should be empty if using the uri |
6.10.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| -u, --uninstall-all | Uninstall all features from the repository |
6.11. feature:requirement-add
6.11.1. Description
Add provisioning requirements.
6.11.2. Syntax
feature:requirement-add [options] requirements
6.11.3. Arguments
| Name | Description |
|---|---|
| requirements |
6.11.4. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --features-wiring | Print the wiring between features |
| --help | Display this help message |
| -v, --verbose | Explain what is being done |
| --all-wiring | Print the full wiring |
| --store | Store the resolution into the given file and result for offline analysis |
| -r, --no-auto-refresh | Do not automatically refresh bundles |
| -s, --no-auto-start | Do not start the bundles |
| -m, --no-auto-manage | Do not automatically manage bundles |
| -g, --region | Region to install to |
6.12. feature:requirement-list
6.12.1. Description
List provisioning requirements.
6.12.2. Syntax
feature:requirement-list [options]
6.12.3. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| --no-format | Disable table rendered output |
6.13. feature:requirement-remove
6.13.1. Description
Remove provisioning requirements.
6.13.2. Syntax
feature:requirement-remove [options] requirements
6.13.3. Arguments
| Name | Description |
|---|---|
| requirements |
6.13.4. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --features-wiring | Print the wiring between features |
| --help | Display this help message |
| -g, --region | Region to apply to |
| -v, --verbose | Explain what is being done |
| --all-wiring | Print the full wiring |
| --store | Store the resolution into the given file and result for offline analysis |
| -r, --no-auto-refresh | Do not automatically refresh bundles |
| -s, --no-auto-start | Do not start the bundles |
| -m, --no-auto-manage | Do not automatically manage bundles |
6.14. feature:start
6.14.1. Description
Start features with the specified name and version.
6.14.2. Syntax
feature:start [options] feature
6.14.3. Arguments
| Name | Description |
|---|---|
| feature | The name and version of the features to start. A feature id looks like name/version. |
6.14.4. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --help | Display this help message |
| -g, --region | Region to apply to |
| -v, --verbose | Explain what is being done |
6.15. feature:stop
6.15.1. Description
Stop features with the specified name and version.
6.15.2. Syntax
feature:stop [options] feature
6.15.3. Arguments
| Name | Description |
|---|---|
| feature | The name and version of the features to stop. A feature id looks like name/version. |
6.15.4. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --help | Display this help message |
| -g, --region | Region to apply to |
| -v, --verbose | Explain what is being done |
6.16. feature:uninstall
6.16.1. Description
Uninstalls a feature with the specified name and version.
6.16.2. Syntax
feature:uninstall [options] features
6.16.3. Arguments
| Name | Description |
|---|---|
| features | The name and version of the features to uninstall. A feature id looks like name/version. The version is optional. |
6.16.4. Options
| Name | Description |
|---|---|
| -t, --simulate | Perform a simulation only |
| --help | Display this help message |
| -v, --verbose | Explain what is being done |
| -r, --no-auto-refresh | Do not automatically refresh bundles |
| -g, --region | Region to install to |
6.17. feature:version-list
6.17.1. Description
Lists all versions of a feature available from the currently available repositories.
6.17.2. Syntax
feature:version-list [options] feature
6.17.3. Arguments
| Name | Description |
|---|---|
| feature | Name of feature. |
6.17.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| --no-format | Disable table rendered output |
