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]

Syntax conventions

Description

The p4 property command can be used by administrators to view and update property definitions stored in the Helix Core service. The service does not use the property definitions. Instead, it provides this capability for client applications, such as P4V.

The Helix Core 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

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
N/A	N/A	`list` to list property values `admin` to add or delete new properties, or to show a property setting and sequence number for all users and groups

N/A

list to list property values

admin to add or delete new properties, or to show a property setting and sequence number for all users and groups

Helix Server administrators can use p4 property to centrally manage P4V’s performance settings and selectively enable/disable features. See Server-side P4V settings in the Helix Core Server Administrator Guide.

Examples

To set a property:

p4 property -a -n P4V.Features.Markdown -v Off

To see a list of all the properties that have been set:

p4 property -l

To see a list of all the properties that have been set for a specific subset of properties:

p4 property -l -n P4V.Features

p4 property -l -n P4V.Performance