list files

Displays the file tree or files that match the specified name or pattern of a repository workspace. Items are shown in depth-first ordering.

Aliases:

list file, list f

Usage: scm list files (-w/--workspace | -s/--snapshot | -b/--baseline) <selector> [-C/--components <arg ...>] [-n/--name <arg>] [-R/--remotePath <arg>] [-m/--maximum <arg>] [-D/--depth <arg>] [-S/--case-sensitive] [-j/--json] [-i/--show-versionid | -f/--show-full-versionid] [-a/--show-access] [-c/--show-components] [-r/--repository-uri <arg>] [-u/--username <arg> -P/--password <arg> | -u/--username <arg> --password-file <arg> | --certificate <arg> -P/--password <arg> | --smartCard -u/--username <arg> | --kerberos | --integratedWindows]

selector The workspace, stream, snapshot, or baseline (name[@repo], alias, or UUID[@repo]) whose remote files are to be listed. Specify one of --workspace, --snapshot or --baseline. By default the selector will refer to a workspace.

Options:

-w, --workspace Indicates that the selector refers to a workspace or stream.
-s, --snapshot Indicates that the selector refers to a snapshot.
-b, --baseline Indicates that the selector refers to a baseline.
-C, --components <arg ...> The components for which to list the files for a workspace, stream, baseline, or snapshot. This option is mandatory if you specify the --baseline option by using a name[@repo] or alias.
-n, --name <arg> Name or pattern (*, ?). Lists all files that contain the specified name or pattern.
-R, --remotePath <arg> The remote path that specifies the root of the list.
-m, --maximum <arg> The maximum number of results that can be returned. The number must be greater than 0. If you omit this option, 10 is used by default. If you specify "all"/"-" then all possible results are displayed. The number of files to list. This option can only be used in conjunction with the --name option. If the --name option is used, the highest value that can be specified for the -m/--maximum option is 2048, and the number of results is limited to 2048.
-D, --depth <arg> The maximum depth at which to query remote paths. To list all paths, set the value of this option to '-'.
-S, --case-sensitive Lists only the files that match the case specified in the --name option. This option can only be used in conjunction with the --name option.
-j, --json Enable JSON output.
-i, --show-versionid Show the version ID for files.
-f, --show-full-versionid Show the full version ID for files.
-a, --show-access Show the read access for files if it is different from Component access.
-c, --show-components Display all the components even if there were no files under it matching the specified criteria.
-r, --repository-uri <arg> The URI that specifies the location of the repository.
-u, --username <arg> The user name for the repository.
-P, --password <arg> The password for the repository.
    --password-file <arg> File that contains the user's password.
    --certificate <arg> The file that contains the user's login certificate.
    --smartCard Use the connected smart card for authentication.
    --kerberos Authenticate with Windows user credentials using Kerberos/SPNeGO.
    --integratedWindows Authenticate with Windows user credentials using Integrated Windows Authentication.


Example