p4 branches

List existing branch mappings.

Syntax

p4 [g-opts] branches [[-e | -E] nameFilter] [-m max][-t] [-u user [--user-case-insensitive] | --me]

Syntax conventions

Description

Print the list of all branch mappings currently known to the system.

Use the -m max option to limit the output to the first max branch mappings.

Use the -e or -E filter options to limit the output to branches whose name matches the nameFilter pattern. The -e option is case-sensitive, and -E is case-insensitive.

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

Options

-E filter	List only branches matching filter. Unlike the -e option, this option operates in a case-insensitive manner, even on a case-sensitive server.
-m max	List only the first max branch mappings.
-t	Display the time as well as the date of the last update to the branch.
--me	Equivalent to -u $P4USER.
g-opts	See Global options.

Examples with the * wildcard

If you use the * wildcard, enclose the search pattern in double quotes (").

-e filter

List only branches matching filter (case-sensitive). Lists branch specs with a name that matches the nameFilter pattern. For example: -e "svr-dev-rel*" Unlike the -E option, this option uses the server's normal case-sensitivity rules.

-u user

List branch specs owned by the specified user. This can include * wildcards to form a search pattern. If wildcards are used, enclose the search pattern in double quotes ("). For example: p4 branches -u "*bert" You can also add the --user-case-insensitive suboption to indicate that the user value is a case-insensitive search pattern, even for a case-sensitive server.

Usage notes

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

The command returns no output if there is no object to report on.

Related commands

To create or edit a branch mapping

p4 branch