p4 labels
Synopsis
Display list of defined labels.
Syntax
p4 [g-opts
] labels [-t] [-u user
] [[-e|-E] filter
] [-m max
] [file
[revrange
]]
p4 [g-opts
] labels [-t] [-u user
] [[-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
labelname
date
description
Use the -t
option to display the time of the last update
to the label.
Label
labelname
date
time
description
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
option to
limit the output to the first max
max
labels.
Use the -e
or -E
options to limit the output
to labels whose name matches the filter
filter
pattern. The -e
option is case-sensitive, and
-E
is case-insensitive.
Use the -u
option to
limit the output to labels owned by the named user.
user
Options
|
List all labels, not just labels bound to this server. This option may not be used with a file specification. |
|
List only labels matching |
|
List only labels matching |
|
List only the first |
|
List only those labels bound to the specified
|
|
Display the time as well as the date of the last update to the label. |
|
List only labels owned by |
|
List labels in the unload depot. For details, see p4 unload. |
|
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 |
|
-
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
options.serverID
Examples
To list all labels in the system |
p4 labels |
To list all labels that contain any revision of
|
p4 labels file.c |
To list only labels containing revisions |
p4 labels file.c#3,5 |