p4 clients

List all client workspaces currently known to the system.

Syntax

p4 [g-opts] clients [-t] [-u user [--user-case-insensitive] | --me] [[-e|-E] filter] [-m max]
                    [-S stream] [-a | -s serverID]
p4 [g-opts] clients -U

Syntax conventions

Description

p4 clients lists all the client workspaces known to the Helix Core Server. Each workspace is reported on a single line of the report. The format of each line is:

Client clientname moddate root clientrootdescription

For example:

Client paris 2009/02/19 root /usr/src 'Joe's client'

describes a client workspace named paris, last modified on February 19, 2009 with a root of /usr/src. The description of the workspace entered in the p4 client form is Joe’s client.

Use the -m max option to limit the output to the first max client workspaces.

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

Use the -u user option to limit the output to workspaces owned by the named user, and the --user-case-insensitive can be applied even on a case-sensitive server.

The command p4 workspaces is an alias for p4 clients.

Options

-a

List all client workspaces, not just workspaces bound to this server.

-e filter

List only client workspaces matching filter (case-sensitive).

-E filter

List only client workspaces matching filter (case-insensitive. even on a case-sensitive Helix Core Server).

--client-case-insensitive is equivalent to -E.

-m max

List only the first max client workspaces.

-s serverID

List only client workspaces bound to the specified serverID. On an edge server, the -s option defaults to the edge server’s serverID.

-S stream

List client workspaces associated with the specified stream.

-t

Display the time as well as the date of the last update to the workspace.

-u user

List client workspaces that are owned by user.

This can include * wildcards to form a search pattern. If wildcards are used, enclose the search pattern in double quotes (").

--me

Equivalent to -u $P4USER.

-U

List only client workspaces unloaded with 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 Command Alias

N/A

N/A

list

p4 workspaces

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

Examples

p4 clients -m 5

List a maximum of five client workspaces for any type of depot.
p4 clients -E "*Us*rs"

Filters the list to find only client workspaces such as the following:

Client p4vBetaUsers 2019/06/25 root /var/log 'Created by maria. '
Client users 2018/11/06 root /home/perforce/users 'Created by bruno.'

p4 clients -u "O*hara" For O'hara, Ohara, Obhara, and so on.
p4 clients -u --user-case-insensitive "O*hara"

For O'hara, O'Hara, Obhara, ObHara, and so on, where the letter h can be uppercase or lowercase.

Related commands

To edit or view a client workspace specification

p4 client

To see the name of the current client workspace and other useful data

p4 info

To view a list of Helix Core Server users

p4 users