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 (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.

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

-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 (").

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.

--me

Equivalent to -u $P4USER.

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

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

Related commands

To create or edit a branch mapping

p4 branch