p4 streams

Display a list of streams.


p4 [g-opts] streams [options] [-U] [streamPath ...]
p4 [g-opts] streams [options] --viewmatch files [streamPath ...]

options: [-a] [-F filter] [-m max] [-T fields]

Syntax conventions


Lists the streams defined in the currently connected service. To filter the list, for example, to list streams for a particular depot, specify the streamPath. (See Stream views and paths in Helix Core Command-Line (P4) Guide)


-F filter

Filter the output according to the contents of specified fields.

-m max

Maximum number of streams to list.

-T fields

Limit field output to fields specified in a list of fields. Field names may be separated by a space or comma. Intended for scripting. This option forces tagged output.


Display task streams unloaded with p4 unload.


Returns the stream name, depot path, and stream view path of the streams that have views containing the given depot files.

-a (Optional) Includes deleted streams when listing the streams.


See the -ztag example in Examples for p4 streams as well as Global options.

Usage Notes

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




If no stream matches the specified argument, the command ignores the argument and returns all streams.

Examples for p4 streams

p4 streams -F "Owner=maria Type=release"

List the release streams owned by maria

p4 -ztag streams -F "deleted" -a

... Stream //streamd1/maria-stream1-mainline
... Name maria-stream1-mainline
... Parent none
... Type mainline
... deleted
... firmerThanParent n/a
... baseParent none
... ParentView inherit
List the streams that have been deleted

p4 streams --viewmatch //gizmo/main/src/sprocket.c

Stream //gizmo/main share ... //gizmo/main/...
Stream //gizmo/virt-src share src/... //gizmo/main/src/...
Stream //widget/main import src/sprocket.c //gizmo/main/src/sprocket.c
List the stream name, stream path type, depot view path, and depot path of the streams whose views include the file //gizmo/main/src/sprocket.c

In this example:

  • //gizmo/main is the mainline stream where the file originates

  • //gizmo/virt-src is a virtual child of //gizmo/main whose view only includes the src/ directory

  • //widget/main is a stream that includes sprocket.c via an import

Related Commands

Create, edit or delete a stream

p4 stream