p4 dirs

Synopsis

Syntax

Description

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

This command is meant to be used in scripts that call Perforce; it is unlikely that you'll have a need to call it from the command-line.

Options

-C	Display only those directories that are mapped through the current client workspace 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.
g_opts	See the Global Options section.

Usage Notes

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

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

• Perforce does not track directories in its database; thus, the subdirectory values are not looked up, but are computed. This accounts for some of the strange details of the p4 dirs implementation, such as the fact that 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.
p4 dirs //depot/...	The "..." wildcard is not supported by p4 dirs.

Related Commands

To list all the files that meet particular criteria	p4 files
To list all depots on the current Perforce server	p4 depots