p4 dirs

List the immediate subdirectories of the specified depot directories.

Syntax

p4 [g-opts] dirs [-C -D -H] [-S stream] [-i] depot_directories*[revSpec]

Description

Use p4 dirs to find the immediate subdirectories of any depot directories provided as arguments.

The depot_directories argument must be provided in depot or local syntax and must end with the * wildcard.

p4 dirs only lists the immediate subdirectories of the directory arguments. To recursively list all of a directory’s subdirectories, call p4 dirs multiple times.

By default, only subdirectories that contain at least one undeleted file will be returned. To include those subdirectories that contain only deleted files, use the -D option.

If you include a revision specifier or revision range as part of a directory argument, the only subdirectories returned are those that contain at least one file revision that matches the given specifier.

Options

-C	Display only those directories that are mapped through the current client view.
-D	Include subdirectories that contain only deleted files. By default, these directories are not displayed.
-H	Include only those directories that contain files on the current client workspace’s p4 have list.
-S stream	List directories mapped for the specified stream.
-i	Ignore the case of the directory argument when listing directories in a case-sensitive server.
g-opts	See Global options.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
Yes	Yes	list

Perforce does not track directories in its database. Therefore, the "..." wildcard is not supported.

Examples

p4 dirs //depot/projects/*	Returns a list of all the immediate subdirectories of //depot/projects.
p4 dirs //depot/a/* //depot/b/*	Returns a list of all immediate subdirectories of //depot/a and //depot/b.

Related Commands

To list all the files that meet particular criteria	p4 files
To list all depots known to the Helix Server	p4 depots