Helix Core is now P4. Product user interfaces will be updated soon. Learn more >>

P4 CLI Documentation | 2025.2

# 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 and naming 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

Option | Description
--- | ---
`-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`

Your search for returned results