p4 protects
Display protections in place for a given user, group, or path.
Syntax conventions
p4 [g-opts] protects [-s spec][-a | -g group | -u user] [-h host] | -H] [-m] [-S | -A] [file ...]
p4 [g-opts] protects -M [-g group | -u user] [-h host | -H] [file ...]
Description
Use the p4 protects
command to display the lines
from the protections table that apply to a user, group, or set of
files.
- With no options,
p4 protects
displays the lines in the protections table that apply to the current user. If afile
argument is provided, only those lines in the protection table that apply to the named files are displayed. - Use the
-a
option to display lines for all users, or-u user
,-g group
, or-h host
options to display lines for a specific user, group, or host IP address. -
Use the
-h host
option to display lines that apply to the specified host (IP address). - Use the
-H host
option to display lines that apply to the current client's host (IP address). - Use the
-m
option to display a one-word summary of the maximum applicable access level, ignoring any provided file path. - Use the
-M
option to display a one-word summary of the maximum access level. Unlike the-m
option, it takes into account the specified file path. -
Use the
-s spec
option to dispay the contents of the file in the spec depot rather than the current protections table. This allows thesuper
user back-in-time access to how permission would have behaved in a previous version of the protections spec.For example, the following command returns information about the user
sam
in the third revision of the protections table:$ p4 -u super protects -s //spec/protect.p4s#3 -u sam write user * * //...
This is useful when users lose access privileges at a given point in time and you want to check what changes were made to the protection table just before that date.
To use this option, you must define a spec depot for protect forms. This automatically saves revisions to the protect specification every time you edit the protection table. For information on how to create a spec depot, see
p4 depot
- Use the
-S
option to report only stream spec protection lines. - Use the
-A
option to report both stream spec and stream file lines.
Options
|
Display protection lines for all users. This option requires
|
|
Display protection lines that apply to the named
|
|
Display protection lines that apply to the specified
|
|
Display protection lines that apply to the current client's
IP address. This option requires
|
|
Display a one-word summary of the maximum applicable access level. (Note: this does not take into account exclusionary mappings or the specified file path into account.) |
-M
|
Differs from -m because -M does take into account
exclusions and the specified file path.
|
|
Display information from the specified earlier version of the
protect file. The |
|
Display protection lines that apply to the named
|
-S
|
Display only stream spec protection lines. |
-A
|
Display file and stream spec protection lines. |
|
See Global options. |
Usage Notes
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
No |
No |
list, |
- If the
dm.protects.allow.admin
configurable is set to1
, Helix server administrators, in addition to Helix server superusers, can also usep4 protects -a
,-g
, and-u
.
Related Commands
To edit the protections table |