summaryrefslogtreecommitdiffstats
path: root/man/bcfg2.1
blob: ac940988b61061eacf944446645c757b1c094b03 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
.TH "bcfg2" 1
.SH NAME
bcfg \- reconfigure machine based on settings in BCFG2
.SH SYNOPSIS
.B bcfg2
.I [-d] [-v] [-p] [-c cache file] [-e] [-f config file] [-I] [-q] [-b bundle]
[-r removal mode]
.SH DESCRIPTION
.PP
.B bcfg2
Runs the bcfg2 configuration process on the current host. This process
consists of first fetching and executing probes, uploading probe
results, fetching the client configuration, checking the current
client state, attempting to install the desired configuration, and
finally uploading statistics about the bcfg2 execution and client
state.
.SH OPTIONS
.PP
.B "\-d" 
.RS
Run bcfg2 in debug mode.
.RE 
.B "\-v"
.RS
Run bcfg2 in verbose mode.
.RE
.B "\-c <cachefile>"
.RS 
Cache a copy of the configuration in cachefile
.B "\-b <bundle>"
.RS
Run bcfg2 against only one bundle in the configuration. 
.RE
.B "\-P" 
.RS
Run bcfg2 in paranoid mode. Diffs will be logged for
configuration files marked as paranoid by the Bcfg2 server.
.RE
.B "\-q"
.RS
Run bcfg2 in quick mode. Package checksum verification won't be
performed. This mode relaxes the constraints of correctness, and thus
should only be used in safe conditions. 
.RE
.B "\-D <driver1>,<driver2>"
.RS
Specify a set of bcfg2 tool drivers. NOTE: only drivers listed will be
loaded. (IE, if you don't include POSIX, you will be unable to
verify/install ConfigFiles, etc)
.RE
.B "\-I"
.RS
Run bcfg2 in interactive mode.  The user will be prompted before each 
change.
.RE
.B "\-n"
.RS
Run bcfg2 in dry-run mode. No changes will be made to the
system. 
.RE
.B "\-B"
.RS 
Run bcfg2 in build mode. Services aren't started, as the system
may still be in miniroot.
.RE
.B "\-r <mode>" 
.RS
Cause bcfg2 to remove extra configuration elements it detects. Mode is one of all, services, or packages. All removes all entries. Likewise, services and packages remove only the extra configuration elements of the respective type.
.RE
.B "\-p <profile>" 
.RS
Assert a profile for the current client.
.RE
.B "\-e" 
.RS
When in verbose mode, display extra entry information (temporary until
verbosity rework)
.RE
.B "\-k" 
.RS
Run in bulletproof mode. This currently only effect behavior in the
debian toolset; it calls apt-get update and clean and dpkg --configure --pending.
.RE
.SH "SEE ALSO"
.BR bcfg2-server(8),
.BR bcfg2-info(8)
.SH "BUGS"