Perforce 2005.2 Command Reference
<< Previous Chapter
p4 labels
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 lock

p4 labelsync

Synopsis

Synchronize a label with the contents of the current client workspace.

Syntax

p4 [g-opts] labelsync [-a -d -n] -l labelname [file[revRange]...]

Description

p4 labelsync causes the named label to reflect the current contents of the client workspace by tagging the last revision of each file synced into the workspace with the label name. The label name can subsequently be used in a revision specification as @label to refer to the revision of the file that was tagged with the label.

Without a file argument, p4 labelsync causes the label to reflect the contents of the client workspace by adding, deleting, and updating the set of files tagged with the label.

If a file is given, p4 labelsync updates the tag for only that named file. If the file argument includes a revision specification, then that revision is used instead of the revision existing in the workspace. If the file argument includes a revision range, then only the highest revision in that range is used.

Only the Owner: of an unlocked label may use p4 labelsync to tag files with that label.

A label that has its Options: field set to locked cannot be updated with p4 labelsync.

Options

-a

Add the label to files that match the file pattern arguments, even if some of the files being labeled are deleted at their head revision.

-d

Delete the label tag from the named files.

-l labelname

Specify the label to be applied to file revisions

-n

Display what p4 labelsync would do without actually performing the operation.

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

Yes

Yes

open

Related Commands

To create or edit a label

p4 label

To list all labels known to the system

p4 labels

To create a label and tag files with the label

p4 tag


Perforce 2005.2 Command Reference
<< Previous Chapter
p4 labels
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 lock
Please send comments and questions about this manual to [email protected].
Copyright 1999-2005 Perforce Software. All rights reserved.
Last updated: 12/15/05