Perforce Command Reference:   [Index] [Prev] [Next]


p4 label

Synopsis

Create or edit a label specification and its view

Syntax

p4 [g-opts] label [ -f -t template ] labelname
p4 [g-opts] label -o [ -t template ] labelname
p4 [g-opts] label -d [ -f ] labelname
p4 [g-opts] label -i [ -f ]

Description

Create a new label specification or edit an existing label specification. A name is required. The specification form is put into a temporary file and the editor is invoked.

Running p4 label merely lists the files that are allowed to be included in the label. You'll need to use p4 labelsync to store files within the label.

Form Fields

Field Name Type Description
Label: Read-only The label name as provided in the invoking command.
Owner: Writable The owner of the label. By default, the user who created the label.
Update: Read-only The date the label specification was last modified.
Access: Read-only The date and time that p4 labelsync was last run using this label.
Description: Writable, optional A description of the label's purpose. Optional.
Options: Writable locked or unlocked. If the label is locked, its contents can't be changed with p4 labelsync.
View: Writable A list of depot files that can be included in this label. No files are actually included until p4 labelsync is invoked. Unlike client views or branch views, which map one set of files to another, label views consist of a simple list of depot files. Please see the Views chapter for more information.

Options

-d [-f] Delete the named label if it's unlocked. The -f flag forces the deletion even if the label is locked.
-i Read the label definition from standard input without invoking the editor.
-o Write the label definition to standard output without invoking the editor.
-f Allows the Update: field's date to be set. Can be used with either the -i flag or the -t flag for the same purpose.
-t template Copy label template's view into the View: field of this label.
g_opts See global options section.

Usage Notes

Can File Arg Use
Revision Specifier?
Can File Arg
Use Revision Range?
Minimal
Access Level Required
<NA> <NA> open

Related Commands

To include client workspace files in a label p4 labelsync
To list all labels known to the system p4 labels



Perforce Command Reference:   [Index] [Prev] [Next]


Copyright 1999 Perforce Software.
Contact us at [email protected]
Last updated: 09/15/99 (Manual version 99.1.cr.6)