tizen 2.3 release
[external/buxton.git] / docs / buxton.7
1 '\" t
2 .TH "BUXTON" "7" "" "buxton 1" "buxton"
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 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el       .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 buxton \- A security\-enabled configuration system
24
25 .SH "DESCRIPTION"
26 .PP
27 Buxton is a security\-enabled configuration management system\&. It
28 features a layered approach to configuration storage, with each layer
29 containing an arbitrary number of groups, each of which may contain
30 key\-value pairs\&. Mandatory Access Control (MAC) is implemented at
31 the group level and at the key\-value level\&.
32
33 Currently, buxton uses \m[blue]\fBSmack\fR\m[]\&\s-2\u[1]\d\s+2 to
34 enforce MAC\&.
35
36 Buxton provides a C library, documented in \fBbuxton\-api\fR(7), for
37 client applications to use\&. Internally, buxton uses
38 \fBbuxtond\fR(8) for processing client requests and enforcing
39 MAC\&. Also, \fBbuxtonctl\fR(1) is provided for interactive use and
40 for use in shell scripts\&.
41
42 Minimal examples of client API usage are found in
43 \fBbuxton\-examples\fR(7), and an in\-depth overview of buxton is
44 found in \fBbuxton\-overview\fR(7)\&.
45
46 .SH "COPYRIGHT"
47 .PP
48 Copyright 2014 Intel Corporation\&. License: Creative Commons
49 Attribution\-ShareAlike 3.0 Unported\s-2\u[2]\d\s+2\&.
50
51 .SH "SEE ALSO"
52 .PP
53 \fBbuxtonctl\fR(1),
54 \fBbuxtond\fR(8),
55 \fBbuxton\-api\fR(7),
56 \fBbuxton\-examples\fR(7),
57 \fBbuxton\-overview\fR(7)
58
59 .SH "NOTES"
60 .IP " 1." 4
61 Smack
62 .RS 4
63 \%https://www.kernel.org/doc/Documentation/security/Smack.txt
64 .RE
65 .IP " 2." 4
66 Creative Commons Attribution\-ShareAlike 3.0 Unported
67 .RS 4
68 \%http://creativecommons.org/licenses/by-sa/3.0/
69 .RE