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 Helix Core Command-Line (P4) Guide)

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