p4 property

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 Helix Server 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

-a	Update a property value, or add a property value if it is not yet present. Requires admin access.
-A	List properties for all users and groups, as well as the property sequence number of each property value. Requires admin access.
-d	Delete a property value. Requires admin access.
-F filter	Limit the properties displayed to those that match the filter pattern. Syntax is that used by p4 fstat.
-g group	Specify the user group to which this property applies.
-l	List one or more property values. Performance is substantially improved when you supply a -n name argument.
-m max	Limit output to the first max matching properties.
-n name	Specify the name of the property.
-s sequence	Specify the sequence number of the property. If not specified, the default value is 1.
-T taglist	Limit the fields that are displayed to the fields listed in taglist. Syntax is that used by p4 fstat.
-u user	Specify the user to whom this property applies.
-v value	Specify the value of the property.
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, admin

• Helix Server administrators can use p4 property to centrally manage P4V’s performance settings and selectively enable/disable features.

  See the Helix Core Server Administrator Guide: Fundamentals for details.