summaryrefslogtreecommitdiffstats
path: root/doc/man/bcfg2-info.txt
blob: 0ce3ddd1120cac8b518b6986878221127749d784 (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
.. -*- mode: rst -*-
.. vim: ft=rst

bcfg2-info
==========

.. program:: bcfg2-info

Synopsis
--------

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

Description
-----------

:program:`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 path           Specify the path to the server repository.
-d                Enable debugging output.
-h                Print usage information.
-p profile        Specify a profile.
-x password       Use 'password' for client communication.

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
--------

:manpage:`bcfg2(1)`, :manpage:`bcfg2-server(8)`