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

Examples with the * wildcard

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

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 P4 Server users	`p4 users`