usecase list command
The usecase list command allows the user to search for use case scripts in various locations.
The output reports the location searched for use cases and, if any use case scripts are found, prints a table listing:
- The script name.
- Entry points to the script. Each entry point defines a single use case.
- The title of each use case.
- The description of each use case, if defined.
If a usecase list command is issued without any parameters on the command line, DS-5 reports all the use case scripts it finds in the current directory.
A usecase list path/to/directory/ command lists any use case scripts it finds in the directory specified. The usecase list command accepts relative paths to locations as well as tilde (~) as the user home directory on Unix based systems.
Several use cases are shipped with DS-5 and are found in the default configuration database under /Scripts/usecase/. When creating a use case it can be added to /Scripts/usecase/ in the default database, or a custom user database. These scripts are also listed by the usecase list -s command.
Use case scripts might be platform specific, and use cases can be defined as only visible for the current target. A use case script created in the configuration database in /Boards/<Manufacturer>/<Platform>/ is only visible when a connection is made to the <Manufacturer>/<Platform> configuration.
usecase list -p lists all use case scripts associated with the current platform. For example if a connection was made to the configuration in /ARM FVP (Installed with DS-5)/VE_AEMv8x1/ and the usecase list -p was run, only use case scripts in this directory for the current configuration are listed.
Issuing usecase list -a lists all scripts in the current working directory, in /Scripts/usecase/ in the configuration database, and those for the current platform.