Perforce 2008.1 Command Reference
<< Previous Chapter
p4 label
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 labelsync

p4 labels

Synopsis

Display list of defined labels.

Syntax

p4 [g-opts] labels [ -u user ] [ -e namefilter -m max ] [ file[revrange] ]

Description

p4 labels lists all the labels known to the Perforce server in the form:

To see a list of static labels that tag specific files, specify a file pattern, with an optional revision range. (Because automatic labels refer to all files in the label view at a specified revision range, automatic labels are not shown when you use p4 labels with a file pattern.)

Use the -m max option to limit the output to the first max labels.

Use the -e namefilter option to limit the output to labels whose name matches the namefilter pattern.

Use the -u user option to limit the output to labels owned by the named user.

Options

-m max

List only the first max labels.

-e namefilter

List only labels matching namefilter.

-u user

List only labels owned by user.

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

list

Examples

To list all labels in the system

p4 labels

To list all labels that contain any revision of file.c

p4 labels file.c

To list only labels containing revisions #3 through #5 of file.c

p4 labels file.c#3,5

Related Commands

To create a label and tag files with the label

p4 tag

To create or edit a label specification

p4 label

To add, delete, or change the files included in a label

p4 labelsync

To view a list of files included in a label

p4 files @labelname


Perforce 2008.1 Command Reference
<< Previous Chapter
p4 label
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 labelsync
Please send comments and questions about this manual to [email protected].
Copyright 1999-2008 Perforce Software. All rights reserved.
Last updated: 07/08/08