p4 streams

Display a list of streams.

Syntax

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

Description

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 the P4 CLI Documentation)

Options

`-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 can be separated by a space or comma. Intended for scripting. This option forces tagged output.
`-U`	Display task streams unloaded with `p4 unload`.
`--viewmatch`	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.
`g-opts`	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
N/A	N/A	`list`

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