summaryrefslogtreecommitdiffstats
path: root/tools/manpagegen/bcfg2-info.8.ronn
blob: e19149ca8eab71185ecf5d341a347b15993c6365 (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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
bcfg2-info(8) -- Creates a local version of the Bcfg2 server core for state observation
=======================================================================================

## SYNOPSIS

`bcfg2-info` [<-C configfile>] [-E <encoding>] [-Q <repository path>]
[-h] [-p] [-x <password>] [<mode>] [<mode args>] [<mode options>]

## DESCRIPTION

`bcfg2-info` instantiates an instance of the Bcfg2 core for data
examination and debugging purposes.

## OPTIONS

  * `-C` <configfile>:
    Specify alternate bcfg2.conf location

  * `-E` <encoding>:
    Specify the encoding of config files.

  * `-Q` <repository path>:
    Specify the server repository path.

  * `-d`:
    Run in debug mode.

  * `-h`:
    Give a bit of help about the command line arguments and options.
    After this bcfg2-info exits.

  * `-p`:
    Specify a profile.

  * `-x` <password>:
    Set the communication password.

## MODES


  * `build` <hostname> <filename>:
    Build config for hostname, writing to filename.

  * `buildall` <directory>:
    Build configs for all clients in directory.

  * `buildallfile` <directory> <filename> [<hostnames>]:
    Build config file for all clients in directory.

  * `buildbundle` <filename> <hostname>:
    Build bundle for hostname (not written to disk). If filename is a
    bundle template, it is rendered.

  * `builddir` <hostname> <dirname>:
    Build config for hostname, writing separate files to dirname.

  * `buildfile` [--altsrc=<altsrc>] <filename> <hostname>:
    Build config file for hostname (not written to disk).

  * `bundles`:
    Print out group/bundle information.

  * `clients`:
    Print out client/profile information.

  * `config`:
    Print out the configuration of the Bcfg2 server.

  * `debug`:
    Shell out to native python interpreter.

  * `event_debug`:
    Display filesystem events as they are processed.

  * `groups`:
    List groups.

  * `help`:
    Print the list of available commands.

  * `mappings` [<entry type>] [<entry name>]:
    Print generator mappings for optional type and name.

  * `packageresolve` <hostname> <package> [<package>...]:
    Resolve the specified set of packages.

  * `packagesources` <hostname>:
    Show package sources.

  * `profile` <command> <args>:
    Profile a single bcfg2-info command.

  * `quit`:
    Exit bcfg2-info command line.

  * `showentries` <hostname> <type>:
    Show abstract configuration entries for a given host.

  * `showclient` <client1> <client2>:
    Show metadata for given hosts.

  * `update`:
    Process pending file events.

  * `version`:
    Print version of this tool.

## SEE ALSO

bcfg2(1), bcfg2-server(8)