p4 stream

Synopsis

Create, edit or delete a stream specification.

Syntax


p4 [g-opts] stream [-P parent] -t type name
p4 [g-opts] stream [-f] [-d] [-o [-v]] [-P parent] -t type name
p4 [g-opts] stream -i [-f]

Description

The p4 stream command enables you to maintain Perforce streams, which are hierarchical branches with policies that control the structure and the flow of change. Stream hierarchies are based on the stability of the streams, specified by the type you assign to the stream. Development streams are least stable (most subject to change), mainline streams are somewhat stable, and release streams are highly stable. Virtual streams can be used to copy and merge between parent and child streams without storing local data. Task streams are lightweight short-lived branches that are useful for bug fixing or new features that only modify a small subset of the branch data.

Stream contents are defined by the paths that you map. By default, a stream has the same structure as its parent (the stream from which it was branched), but you can override the structure, for example to ensure that specified files cannot be submitted or integrated to other streams.

For a detailed discussion of streams, refer to the P4 User's Guide.

Form Fields

Field Name

Type

Description

Stream:

Writable, mandatory

Specifies the stream's name (permanent identifier) and its path in the stream depot, in the form //depotname/streamname.

Update:

Read-only

The date the stream specification was last modified.

Access:

Read-only

The date and time that the stream specification was last accessed by any Perforce command.

Owner:

Writable, mandatory

The Perforce user or group who owns the stream. The default is the user who created the stream.

Name:

Writable

Display name of the stream. Unlike the Stream: field, this field can be modified. Defaults to the streamname portion of the stream path.

Parent:

Writable

The parent of this stream. Must be none if the stream's Type: is mainline, otherwise must be set to an existing stream identifier of the form //depotname/streamname.

Type:

Writable, mandatory

The stream's type determines the expected flow of change. Valid stream types are mainline, virtual, development, and release.

  • mainline

    The mainline stream is the parent of all streams in the stream depot. Every stream depot must have at least one mainline stream.

  • virtual

    Virtual streams allow merging and copying between parent and child streams without storing local data. Data is passed through to the destination (a non-virtual stream) after applying restrictions on the scope of files defined in the virtual stream's view.

  • release

    More stable than the mainline. Release streams copy from the parent and merge to the parent.

  • development

    Less stable than the mainline. Development streams expect to merge from parent streams and copy to the parent.

  • task

    Task streams are lightweight short-lived branches that are useful for bug fixing or new features that only modify a small subset of the branch data. Because branched (copied) files are tracked in a set of shadow tables which are later removed, repository metadata is kept to a minimum when using this type of stream. Workspaces associated with task streams see all branched data, but only modified and promoted data is visible to users with access to the stream's namespace.

The default is stream type is development.

Description:

Writable, optional

Description of the stream.

Options:

Writable

Settings that configure stream behavior as follows:

  • [un]locked

    Enable/disable other users' ability to edit or delete the stream. If locked, the stream specification cannot be deleted, and only its owner can modify it. The default is unlocked.

  • [all|owner]submit

    Specifies whether all users or only the owner of the stream can submit changes to the stream. The default is allsubmit. If the Owner: of a stream marked ownersubmit is a group, all users who are members of that group can submit changes to the stream.

  • [no]toparent

    Specifies whether integrations from the stream to its parent are expected. The default is toparent.

  • [no]fromparent

    Specifies whether integrations to the stream from its parent are expected. The default is fromparent for mainline and development streams, and nofromparent for release streams.

A virtual stream must have its flow options set to notoparent and nofromparent.

Flow options are ignored for mainline streams

Paths:

Writable

Paths define how files are incorporated into the stream structure. Specify paths using the following format:

path_type view_path [depot_path]

where path_type is a single keyword, view_path is a file path with no leading slashes, and the optional depot_path is a file path beginning with //.

The default path is share ...

Valid path types are:

  • share view_path

    Specified files can be synced, submitted, and integrated to and from the parent stream.

  • isolate view_path

    Specified files can be synced and submitted, but cannot be integrated to and from the parent stream.

  • import view_path [depot_path]

    Specified files can be synced, but cannot be submitted or integrated to and from the parent stream. The view_path is mapped as in the parent stream's view, or to an (optional) depot_path.

    The depot_path may include a changelist specifier; clients of that stream will be limited to seeing revisions at that change or lower within that depot path. For example, you can specify a depot path like this: //depot/import/...@1000. Revisions from changlists greater than 1000 will be automatically hidden from most commands.

    The changelist limits in effect for a given client are dislayed in a read-only client spec field called Change View.

  • exclude view_path

    Specified files cannot be synced, submitted or integrated to and from the parent stream.

By default, streams inherit their structure from the parent stream (except mainlines, which have no parent).

Paths are inherited by child stream views; a child stream's path can downgrade the inherited view, but not upgrade it. (For example, a child stream can downgrade a shared path to an isolated path, but if the parent stream defines a path as isolated, its child cannot restore full access by specifying the path as shared.)

Note that the depot_path is relevant only when the path_type is import.

Remapped:

Writable, optional

Reassigns the location of workspace files. To specify the source path and its location in the workspace, use the following syntax:

view_path_1 view_path_2

where view_path_1 and view_path_2 are Perforce view paths (omit leading slashes and leading or embedded wildcards; terminal wildcards are fine). For example, to ensure that files are synced to the local ProjectX folder, remap as follows:

... projectX/...

Line ordering in the Remapped: field is significant: if more than one line remaps the same files, the later line takes precedence. Remappings are inherited by child streams and the workspaces associated with them.

Ignored:

Writable, optional

A list of file or directory names to be ignored in client views. For example:

/tmp # ignores files named "tmp"
/tmp/... # ignores directories named "tmp"
.tmp # ignores file names ending in .tmp

Lines in the Ignored: field can appear in any order. Ignored files and directories are inherited by child stream client views.

Options

-d streamname

Delete the stream specification. A stream specification cannot be deleted if it is referenced by child streams or stream client workspaces. Deleting a stream does not remove its files; however, changes can no longer be submitted to the stream.

-f

Administrators can use the -f flag to delete or modify locked streams owned by other users.

-i

Read the stream specification from standard input.

-o

Write the stream specification to standard output.

-o -v

Verbose option; includes the automatically-generated client view for this stream.

-P parent

When creating a new stream specification, specify the stream's parent. (This option has no effect on an existing stream specification.)

-t type

When creating a new stream specification, you must specify the stream's type: either mainline, development, release, task, or virtual.

g-opts

See the Global Options section.

Usage Notes

Can File Arguments Use Revision Specifier?

Can File Arguments Use Revision Range?

Minimal Access Level Required

N/A

N/A

open

  • As the name implies, task streams are intended to be short-lived; after you have finished using a task stream by promoting your changes to its parent, delete the task stream.

Examples

p4 stream -t development -P main //projectX/bruno-dev

Create a development stream for project X by branching the mainline.

Related Commands

List streams

p4 streams

Create stream depot

p4 depot

Hide partial matches
Highlight matches
0 matching pages