flux-getattr(1)

SYNOPSIS

flux getattr name
flux setattr [--force] name value
flux lsattr [--values]

DESCRIPTION

The Flux broker attribute subsystem provides a primitive key-value configuration mechanism for the broker. Attributes can be set on the broker command line with flux broker --setattr, then read, written, or listed using flux getattr, flux setattr, or flux lsattr after the broker is running.

Attribute scope is local to an individual broker. That is, broker ranks may have different values for a given attribute.

flux-broker-attributes(7) provides a catalog of attributes.

COMMANDS

getattr

flux getattr retrieves the value of an attribute.

setattr

flux setattr assigns a value to an attribute. If the attribute does not exist, it is created.

-f, --force: Force an attribute to be set, even if it is not documented to respond to runtime updates.

lsattr

flux lsattr lists attributes.

-v, --values: List the attribute values too.

RESOURCES

Flux: http://flux-framework.org

Flux RFC: https://flux-framework.readthedocs.io/projects/flux-rfc

Issue Tracker: https://github.com/flux-framework/flux-core/issues