Helix Core is now P4. Product user interfaces will be updated soon. Learn more >>

P4 CLI Reference | 2025.1

# 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`

Your search for returned results