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

-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