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 conventions

Description

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

For each user, the output includes the Helix Core Server user name, 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

Important

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 master or commit 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

-a

Include service users in the list.

-c

On replica servers, only user information from the master server are reported.

-l

Login information: includes time of last password change and login ticket expiry, if applicable. You must be a Helix Core 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 has been 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