This shows you the differences between two versions of the page.
| — |
xfce:xfconf:xfconf-query [2012/04/29 14:28] (current) andrzejr created |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Xfconf-query ====== | ||
| + | |||
| + | Xfconf-query is a Command Line Interface (CLI) tool for accessing configuration data stored in [[xfce:xfconf:|Xfconf]]. Settings can be displayed and changed in real time. In most cases, any modifications will immediately be propagated to respective applications. Similarly, xfconf-query can display most current configuration options set by the applications or monitor configuration channels for any changes. | ||
| + | |||
| + | ===== Usage ===== | ||
| + | |||
| + | xfconf-query [OPTION...] | ||
| + | |||
| + | ==== Available options ==== | ||
| + | |||
| + | ? -h, --help | ||
| + | ! Show help options | ||
| + | ? -V, --version | ||
| + | ! Version information | ||
| + | ? -c, --channel | ||
| + | ! The channel to query/modify | ||
| + | ? -p, --property | ||
| + | ! The property to query/modify | ||
| + | ? -s, --set | ||
| + | ! The new value to set for the property | ||
| + | ? -l, --list | ||
| + | ! List properties (or channels if -c is not specified) | ||
| + | ? -v, --verbose | ||
| + | ! Verbose output | ||
| + | ? -n, --create | ||
| + | ! Create a new property if it does not already exist | ||
| + | ? -t, --type | ||
| + | ! Specify the property value type | ||
| + | ? -r, --reset | ||
| + | ! Reset property | ||
| + | ? -R, --recursive | ||
| + | ! Recursive (use with -r) | ||
| + | ? -a, --force-array | ||
| + | ! Force array even if only one element | ||
| + | ? -T, --toggle | ||
| + | ! Invert an existing boolean property | ||
| + | ? -m, --monitor | ||
| + | ! Monitor a channel for property changes | ||
| + | |||
| + | ===== Examples ===== | ||
| + | |||
| + | List all available configuration channels: | ||
| + | |||
| + | xfconf-query -l | ||
| + | |||
| + | List all available properties in the channel ''xfce4-panel'': | ||
| + | |||
| + | xfconf-query -c xfce4-panel -l | ||
| + | |||
| + | List all available properties and their values in the channel ''xfce4-panel'': | ||
| + | |||
| + | xfconf-query -c xfce4-panel -l -v | ||
| + | |||
| + | List all properties and their values in the channel ''xfce4-panel'' below the property ''/panels'' (including it): | ||
| + | |||
| + | xfconf-query -c xfce4-panel -p /panels -l -v | ||
| + | |||
| + | Create a new property ''/test1'' in the channel ''test'', holding an integer value ''1'': | ||
| + | |||
| + | xfconf-query -c test -p /test1 -n -t int -s 1 | ||
| + | |||
| + | Reset (and remove) property ''/test1'' in the channel ''test'' (this preserves any properties under ''/test1'', for example ''/test1/test''): | ||
| + | |||
| + | xfconf-query -c test -p /test1 -r | ||
| + | |||
| + | Reset (and remove) property ''/test1'' in the channel ''test'' and all properties under it: | ||
| + | |||
| + | xfconf-query -c test -p /test1 -r -R | ||
| + | |||
| + | |||
| + | |||
| + | Create a new property ''/test2'' in the channel ''test'', holding an array of two integers and two strings (''[int,int,string,string]''), and preset it with an array ''[4,5,"6","8"]'': | ||
| + | |||
| + | xfconf-query -c test -p /test2 -n -t int -t int -t string -t string -s 4 -s 5 -s 6 -s 8 | ||
| + | |||
| + | Create a new property ''/test3'' in the channel ''test'', holding an array of a single string value (''[string]''), and preset it with an array ''["123"]'' (note that without ''-a'' the property type would be ''string''): | ||
| + | |||
| + | xfconf-query -c test -p /test3 -n -t string -s 123 -a | ||
| + | |||
| + | Monitor changes in the ''xfce4-panel'' channel: | ||
| + | |||
| + | xfconf-query -c xfce4-panel -m | ||
| + | |||
| + | Monitor changes in the ''xfce4-panel'' channel while displaying values of properties being set: | ||
| + | |||
| + | xfconf-query -c xfce4-panel -m -v | ||