p4 labels

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:

Label labelname date description

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.

`-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`

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
N/A	N/A	`list`

To see a list of files tagged by a particular label, use p4 files @labelname.

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`

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`

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

p4 labels

Synopsis

Syntax

Description

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

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`