2 .TH "BUXTONCTL" "1" "" "buxton 1" "buxtonctl"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
17 .\" disable justification (adjust text to left margin only)
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
23 buxtonctl \- Manipulates data stored in the buxton configuration
27 .HP \w'\fBbuxtonctl\fR\ 'u
28 \fBbuxtonctl\fR [OPTIONS...] COMMAND ARGS
33 is used to modify and query configuration, as managed by
38 The following options are understood:
40 \fB\-h\fR, \fB\-\-help\fR
42 Prints a help message\&.
45 \fB\-d\fR, \fB\-\-direct\fR
47 Modifies the configuration directly, without connecting to
48 \fBbuxtond\fR(8)\&. Note that this is a privileged operation\&.
51 \fB\-c\fR FILE, \fB\-\-config\-file\fR FILE
53 Path to a buxton configuration file (see \fBbuxton\&.conf\fR(5))\&.
58 The following commands are understood:
59 .SS "Group manipulation"
61 \fBcreate\-group\fR LAYER GROUP
63 Creates a group within the specified layer\&.
66 \fBset\-label\fR LAYER GROUP LABEL
68 Sets the Smack label for the group in the specified layer\&. Note
69 that this is a privileged operation\&.
72 \fBremove\-group\fR LAYER GROUP
74 Removes a group within the specified layer\&. Note that this
75 operation recursively removes all keys within the given group\&.
77 .SS "Key manipulation"
79 Note that all "get" commands accept an optional LAYER argument\&.
80 Without specifying the layer, the returned value will be taken from
81 the layer with highest priority that the client has permission to
82 read\&. With the layer argument, buxton will try to return the key
83 value only from the given layer\&.
85 \fBget\-string\fR [LAYER] GROUP KEY
87 Gets a key value with string type\&.
90 \fBset\-string\fR LAYER GROUP KEY VALUE
92 Sets a key value with string type\&.
95 \fBget\-int32\fR [LAYER] GROUP KEY
97 Gets a key value with int32_t type\&.
100 \fBset\-int32\fR LAYER GROUP KEY VALUE
102 Sets a key value with string type\&.
105 \fBget\-uint32\fR [LAYER] GROUP KEY
107 Gets a key value with uint32_t type\&.
110 \fBset\-uint32\fR LAYER GROUP KEY VALUE
112 Sets a key value with uint32_t type\&.
115 \fBget\-int64\fR [LAYER] GROUP KEY
117 Gets a key value with int64_t type\&.
120 \fBset\-int64\fR LAYER GROUP KEY VALUE
122 Sets a key value with int64_t type\&.
125 \fBget\-uint64\fR [LAYER] GROUP KEY
127 Gets a key value with uint64_t type\&.
130 \fBset\-uint64\fR LAYER GROUP KEY VALUE
132 Sets a key value with uint64_t type\&.
135 \fBget\-float\fR [LAYER] GROUP KEY
137 Gets a key value with float type\&.
140 \fBset\-float\fR LAYER GROUP KEY VALUE
142 Sets a key value with float type\&.
145 \fBget\-double\fR [LAYER] GROUP KEY
147 Gets a key value with double type\&.
150 \fBset\-double\fR LAYER GROUP KEY VALUE
152 Sets a key value with double type\&.
155 \fBget\-bool\fR [LAYER] GROUP KEY
157 Gets a key value with boolean type\&.
160 \fBset\-bool\fR LAYER GROUP KEY VALUE
162 Sets a key value with boolean type\&.
165 \fBset\-label\fR LAYER GROUP KEY LABEL
167 Sets the Smack label on a key\&. Note that this is a privileged
171 \fBunset\-value\fR LAYER GROUP KEY
173 Unset the value on a key\&. This removes the key from the given
177 .SH "ENVIRONMENT VARIABLES"
179 \fI$BUXTON_CONF_FILE\fR
181 The path to a buxton configuration file (see
182 \fBbuxton\&.conf\fR(5))\&.
185 \fI$BUXTON_MODULE_DIR\fR
187 The directory in which buxton's backend modules reside\&.
190 \fI$BUXTON_DB_PATH\fR
192 The directory that buxtond will use for configuration storage\&.
195 \fI$BUXTON_SMACK_LOAD_FILE\fR
197 The path to the Smack "load2" file, typically residing on the Smack
198 virtual filesystem (smackfs)\&.
201 \fI$BUXTON_BUXTON_SOCKET\fR
203 The path to the Unix Domain Socket used by buxton clients to
204 communicate with buxtond\&.
209 On success, 0 is returned, a non\-zero failure code otherwise\&.
213 Copyright 2014 Intel Corporation\&. License: Creative Commons
214 Attribution\-ShareAlike 3.0 Unported\s-2\u[1]\d\s+2\&.
220 \fBbuxton\-api\fR(7),
221 \fBbuxton\&.conf\fR(5)
225 Creative Commons Attribution\-ShareAlike 3.0 Unported
227 \%http://creativecommons.org/licenses/by-sa/3.0/