p4 labels

Display list of defined labels.

Syntax

p4 [g-opts] labels [-t] [-u user | --me] [[-e|-E] filter] [-m max] [file[revrange]]
p4 [g-opts] labels [-t] [-u user | --me] [[-e|-E] filter] [-m max] [-a | -s serverID]
p4 [g-opts] labels -U

Description

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

Label labelnamedatedescription

Use the -t option to display the time of the last update to the label.

Label labelnamedatetimedescription

To see a list of loaded 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 or -E filter options to limit the output to labels whose name matches the filter pattern. The -e option is case-sensitive, and -E is case-insensitive.

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

Options

`-a`	List all labels, not just labels bound to this server. This option may not be used with a file specification.
`-e filter`	List only labels matching `filter` (case-sensitive).
`-E filter`	List only labels matching `filter` (case-insensitive).
`-m max`	List only the first `max` labels.
`-s serverID`	List only those labels bound to the specified `serverID`. This option may not be used with a file specification.
`-t`	Display the time as well as the date of the last update to the label.
`-u user`	List only labels owned by `user`.
`--me`	Equivalent to `-u $P4USER`.
`-U`	List labels in the unload depot. For details, see `p4 unload`.
`g-opts`	See Global Options.

Usage Notes

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.
In a distributed environment, users connected to an edge server receive only those labels that are bound to their edge server, unless they explicitly request otherwise by specifying the -a or -s serverID options.

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`