p4 dirs
Synopsis
List the immediate subdirectories of specified depot directories.
Syntax
p4 [g-opts
] dirs [-C -D -H] [-S
stream
]
[-i]depot_directory
[revRange
]...
Description
Use p4 dirs
to find the immediate subdirectories of any depot
directories provided as arguments. Any directory 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, then the only subdirectories returned are those that contain at least one file revision that matches the given specifier.
Note
This command is meant to be used in scripts, and it is unlikely that you’ll use it from the command line.
Options
|
Display only those directories that are mapped through the current client view. |
|
Include subdirectories that contain only deleted files. By default, these directories are not displayed. |
|
Include only those directories that contain files on the current
client workspace’s |
|
List directories mapped for the specified stream. |
|
Ignore the case of the directory argument when listing directories in a case-sensitive server. |
|
See “Global Options”. |
Usage Notes
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
Yes |
Yes |
|
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
|
p4 dirs //depot/a/* //depot/b/* |
Returns a list of all immediate subdirectories of |
p4 dirs //depot/... |
The " |