p4 labels
Display the list of defined labels.
Syntax
p4 [g-opts] labels [-U|-R] [-t] [-u user | --me] [[-e|-E] filter] [-m max] [FileSpec[revSpec]]
p4 [g-opts] labels [-U|-R] [-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 Helix Core 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 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
|
List all labels, not just labels bound to this server. This option cannot 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 |
|
Equivalent to |
|
List labels in the unload depot. For details, see |
|
List only labels with the |
|
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 multi-server 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. -
The command returns no output if there is no object to report on.
Examples
To list all labels in the system |
|
To list all labels that contain any revision of file.c |
|
To list only labels containing revisions |
|
Related commands
To create a label and tag files with the label |
|
To create or edit a label specification |
|
To add, delete, or change the files included in a label |
|
To view a list of files included in a label |
p4 files @Labelname |