p4 property
Synopsis
Add, delete, or list property values.
Syntax
p4 [g-opts
] property -a -n name
-v value
[-s sequence
] [-u user
| -g group
]
p4 [g-opts
] property -d -n name
[-s sequence
] [-u user
| -g group
]
p4 [g-opts
] property -l [-A] [-n name
[-s sequence
] [-u user
| -g group
]]
[-F filter
-T taglist
-m max
]
Description
The p4 property command can be used by administrators to view and update property definitions stored in the Perforce service. The service does not use the property definitions; it provides this capability for other Perforce applications, such as P4V.
The Perforce service offers three ways of storing metadata: counters/keys, attributes, and properties.
If your application requires only the flat storage of simple key/value pairs, and attempts to implement no security model, use the p4 counters and p4 keys commands.
If your application's metadata is associated with particular files, use p4 attribute.
If your application's metadata is not associated with files, and if you have a requirement to restrict its visibility to users, groups, and/or to control the precedence of multiple values using sequence numbers, use p4 property.
When specifying multiple property values for the same property, use distinct sequence numbers to specify the precedence order. A value with a higher sequence number is ordered before a value with a lower sequence number. Values with the same sequence number have an undefined ordering relationship.
Options
|
Update a property value, or add a property value if it is not
yet present. Requires |
|
Delete a property value. Requires |
|
List one or more property values. Performance is substantially
improved when you supply a |
|
Specify the name of the property. |
|
Specify the value of the property. |
|
Specify the sequence number of the property. If not specified,
the default value is |
|
Specify the user to whom this property applies. |
|
Specify the user group to which this property applies. |
|
Limit output to the first max matching properties. |
|
Limit the fields that are displayed to the fields listed in
|
|
Limit the properties displayed to those that match the
|
|
List properties for all users and groups, as well as the
property sequence number of each property value. Requires
|
|
See the “Global Options” section. |
Usage Notes
Can File Arguments Use Revision Specifier? |
Can File Arguments Use Revision Range? |
Minimal Access Level Required |
---|---|---|
N/A |
N/A |
|
-
Perforce administrators can use p4 property to centrally manage P4V's performance settings and selectively enable/disable features.
See the Perforce Server Administrator's Guide: Fundamentals for details.