BranchSpec Class |
A branch view specification in a Perforce repository.
Inheritance HierarchySystemObject
Perforce.P4BranchSpec
Perforce.P4BranchSpec
Namespace: Perforce.P4
Assembly: p4api.net (in p4api.net.dll) Version: 2025.1.277.3624
SyntaxThe BranchSpec type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | BranchSpec |
A branch view specification in a Perforce repository.
|
| BranchSpec(String, String, DateTime, DateTime, String, Boolean, ViewMap, FormSpec, String) |
A branch view specification in a Perforce repository.
|
Properties| Name | Description | |
|---|---|---|
 | Accessed |
The date of the last command used with this spec.
|
| Description |
A description of the branch spec (optional).
|
| Id |
The branch spec name (read only).
|
| Locked |
When true, permits only the owner to change the spec.
|
| Options | Obsolete.
Flags to change the branch spec behavior.
|
| Owner |
The user who created this branch spec. Can be changed.
|
| Spec |
Specifies structural and semantic metadata for form types.
|
| Updated |
The date this branch spec was last modified.
|
| ViewMap |
Lines mapping of one view of depot files to another.
|
Methods| Name | Description | |
|---|---|---|
| Equals | (Inherited from Object.) |
 | Finalize | (Inherited from Object.) |
| FromBranchSpecCmdTaggedOutput |
Read the fields from the tagged output of a branch command
|
| FromBranchSpecsCmdTaggedOutput |
Read the fields from the tagged output of a branches command
|
| GetHashCode | (Inherited from Object.) |
| GetType | (Inherited from Object.) |
| MemberwiseClone | (Inherited from Object.) |
| Parse |
Parse the fields from a branch specification
|
| ToString |
Convert to specification in server format
(Overrides ObjectToString.) |
Remarksp4 help branch
branch -- Create, modify, or delete a branch view specification
p4 branch [-f] name
p4 branch -d [-f] name
p4 branch [ -S stream ] [ -P parent ] -o name
p4 branch -i [-f]
A branch specification ('spec') is a named, user-defined mapping of
depot files to depot files. It can be used with most of the commands
that operate on two sets of files ('copy', 'merge', 'integrate',
'diff2', etc.)
Creating a branch spec does not branch files. To branch files, use
'p4 copy', with or without a branch spec.
The 'branch' command puts the branch spec into a temporary file and
invokes the editor configured by the environment variable $P4EDITOR.
Saving the file creates or modifies the branch spec.
The branch spec contains the following fields:
Branch: The branch spec name (read only).
Owner: The user who created this branch spec. Can be changed.
Update: The date this branch spec was last modified.
Access: The date of the last command used with this spec.
Description: A description of the branch spec (optional).
Options: Flags to change the branch spec behavior. The defaults
are marked with *.
locked Permits only the owner to change the spec.
unlocked * Prevents the branch spec from being deleted.
View: Lines mapping of one view of depot files to another.
Both the left and right-hand sides of the mappings refer
to the depot namespace. See 'p4 help views' for more on
view syntax.
New branch specs are created with a default view that maps all depot
files to themselves. This view must be changed before the branch
spec can be saved.
The -d flag deletes the named branch spec.
The -o flag writes the branch spec to standard output. The user's
editor is not invoked.
The -i flag causes a branch spec to be read from the standard input.
The user's editor is not invoked.
The -f flag enables a user with 'admin' privilege to delete the spec
or set the 'last modified' date. By default, specs can be deleted
only by their owner.
A branch spec can also be used to expose the internally generated
mapping of a stream to its parent. (See 'p4 help stream' and 'p4
help streamintro'.)
The -S stream flag will expose the internally generated mapping.
The -P flag may be used with -S to treat the stream as if it were a
child of a different parent. The -o flag is required with -S.
See Also