Perforce 2002.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. It records the last revision of each file synced into the client. The label's name can subsequently be used in a revision specification as @label to refer to the revision of a file as stored in the label.

Without a file argument, p4 labelsync causes the label to reflect the contents of the whole client by adding, deleting, and updating the list of files in the label.

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

You can only update labels you own; if the label's Owner: field is not your userid, you cannot update it with p4 labelsync.

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

Options

-a

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

-d

Delete the named files from the label.

-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

No

open

Related Commands

To create or edit a label

p4 label

To list all labels known to the system

p4 labels


Perforce 2002.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-2003 Perforce Software. All rights reserved.
Last updated: 02/25/03