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

NameDescription

featureName

The name of the feature you want to export bundles for

exportLocation

Where you want to export the bundles

6.1.4. Options

NameDescription

-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

NameDescription

name

The name of the feature

version

The version of the feature

6.2.4. Options

NameDescription

--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

NameDescription

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

NameDescription

-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

NameDescription

-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

NameDescription

regions

Regions to provide detailed info for.

6.5.4. Options

NameDescription

--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

NameDescription

-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

NameDescription

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

NameDescription

--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

NameDescription

--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

NameDescription

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

NameDescription

--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

NameDescription

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

NameDescription

--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

NameDescription

requirements

 

6.11.4. Options

NameDescription

-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

NameDescription

--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

NameDescription

requirements

 

6.13.4. Options

NameDescription

-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

NameDescription

feature

The name and version of the features to start. A feature id looks like name/version.

6.14.4. Options

NameDescription

-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

NameDescription

feature

The name and version of the features to stop. A feature id looks like name/version.

6.15.4. Options

NameDescription

-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

NameDescription

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

NameDescription

-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

NameDescription

feature

Name of feature.

6.17.4. Options

NameDescription

--help

Display this help message

--no-format

Disable table rendered output