p4 login
Synopsis
Log in to the Perforce service by obtaining a ticket.
Syntax
p4 [g-opts
] login [-a -p] [-h
host
]
[user
]
p4 [g-opts
] login
[-s]
p4 [g-opts
] login [-r
remote spec
]
Description
The p4 login
command authenticates a user and creates a ticket
that represents a session with Perforce. Once authenticated, a user can
access the shared versioning service until either the ticket expires or
until the user issues the p4 logout
command.
By default, tickets are valid for 12 hours. This default value is
defined on a per-group basis in the p4 group
form.
To obtain a ticket valid for all IP addresses (for instance, to use
Perforce simultaneously on more than one workstation), use p4 login
-a
. Users with tickets that are valid for all IP addresses still
consume only one Perforce license.
Login attempts, whether successful or not, are logged to a structured log file. If the login fails, the reason for failure is included in the log. In the case of authentication triggers or LDAP authentication, the parts of the error message that contain user data are sanitized as needed.
If you use LDAP authentication, you can set the getattrs
option in the
ldap spec options
field to specify whether the Fullname
and Email
fields for users created by p4 login
should be populated from
the directory.
Options
|
Obtain a ticket that is valid for all IP addresses. |
|
Request a ticket that is valid for the specified host IP address. |
|
Display the ticket, rather than storing it in the local ticket file. |
|
Display the status of the current ticket, if one exists. |
|
Specify the remote server to which the login should be forwarded. If
the remote spec passed in contains a |
|
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 |
|
- To create tickets that do not expire, set the timeout value to
unlimited
in thep4 group
form. - By default, after three failed login attempts, a user must wait 10
seconds before logging in again. Perforce superusers can control the
number of login attempts by setting the
dm.user.loginattempts
configurable. - To extend a ticket’s lifespan, use
p4 login
while already logged in. Your ticket’s lifespan is extended by 1/3 of its initial timeout setting, subject to a maximum of your ticket’s initial timeout setting. - Perforce superusers can obtain login tickets for users other than
themselves without entering passwords. Non-superusers who attempt to
log in as other users must use the
p4 -u username login
form of the command, and correctly supply the other user’s password. - Tickets are stored in the file specified by the
P4TICKETS
environment variable. If this variable is not set, tickets are stored in%USERPROFILE%\p4tickets.txt
on Windows, and in$HOME/.p4tickets
on other operating systems. - The
-h
option causes the service to issue a ticket that is valid on the specified host IP address. This option is typically used with-p
to display a ticket that can subsequently be used on another machine. - In replicated environments, logging in to the master server does not log you in to any replica servers.
Examples
|
Prompt the user for a password; if the password is entered correctly, issue a ticket valid on the user’s machine. |
|
Attempt to log in as user |