p4 users

Print a list of all known users of the current Perforce service.

Syntax

p4 [g-opts] users [-l -a -r -c] [-m max] [user ...]

Syntax and naming conventions

Description

p4 users displays a list of all the users known to the current P4 Server.

For each user, the output includes the P4 Server username, their email address, their real name, and the date the user last accessed the service. For example, Maria <mgonzales@company.com> (Maria Gonzales) accessed 2023/11/22

Emails are not unique in P4 Server. Two or more users can share the same email address. Features that rely on email addresses to identify users, such as single sign-on (SSO) authentication, might behave unexpectedly when multiple users share an email address.

Before you delete users based on their last access time, check the access time directly on the edge and replica servers, in addition to checking the access time on the target server The immediately upstream server for replica servers, edge servers, standby servers, proxies and brokers. See also 'upstream server' and 'central server'..

If a user argument is provided, only information pertaining to that user is displayed. The user argument can contain the * wildcard. All users matching the wildcard pattern are reported on. If you use a wildcard, put the user argument in quotation marks because the operating system might expand the wildcard to match file names in the current directory.

Use the -m max option to limit the output to the first max users.

Options

Option	Description
`-a`	Include service users in the list.
`-c`	On replica servers, only user information from the target server The immediately upstream server for replica servers, edge servers, standby servers, proxies and brokers. See also 'upstream server' and 'central server'. is reported.
`-l`	Login information: includes time of last password change and login ticket expiry, if applicable. You must be a P4 Server superuser to use this option.
`-m max`	List only the first `max` users.
`-r`	On replica servers, only users who have used this replica server are reported. Returns `No such user(s)` if `rpl.forward.login` is set to `1`.
`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`

You must be connected to a replica to use -c or -r, and the -c and -r options are mutually exclusive.
If the run.users.authorize configurable is set to 1, users must authenticate themselves to the Perforce service before running the p4 users command.

Related commands

To add or edit information about a particular user	`p4 user`
To edit information about the current client workspace	`p4 client`