p4 clients

List all client workspaces currently known to the system.

Syntax

p4 [g-opts] clients [-t] [-u user | --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.

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).
`-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 only client workspaces owned by `user`.
`--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 *Users

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

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