bindctl_main.py.in 6.53 KB
Newer Older
1 2
#!@PYTHON@

3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
# Copyright (C) 2009  Internet Systems Consortium.
#
# Permission to use, copy, modify, and distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SYSTEMS CONSORTIUM
# DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
# INTERNET SYSTEMS CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
# INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
# FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
# NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
# WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

18 19
"""This is the main calling class for the bindctl configuration and
   command tool. It sets up a command interpreter and runs that."""
20

21
import sys; sys.path.append ('@@PYTHONPATH@@')
22 23 24 25 26

from bindctl.moduleinfo import *
from bindctl.bindcmd import *
import pprint
from optparse import OptionParser, OptionValueError
27
import isc.util.process
Michal Vaner's avatar
Michal Vaner committed
28

29
isc.util.process.rename()
30

31 32 33
# This is the version that gets displayed to the user.
# The VERSION string consists of the module name, the module version
# number, and the overall BIND 10 version number (set in configure.ac).
34
VERSION = "bindctl 20110217 (BIND 10 @PACKAGE_VERSION@)"
35

36
DEFAULT_IDENTIFIER_DESC = "The identifier specifies the config item. Child elements are separated with the '/' character. List indices can be specified with '[i]', where i is an integer specifying the index, starting with 0. Examples: 'Boss/start_auth', 'Recurse/listen_on[0]/address'. If no identifier is given, shows the item at the current location."
37

38
def prepare_config_commands(tool):
39
    '''Prepare fixed commands for local configuration editing'''
40 41 42
    module = ModuleInfo(name = CONFIG_MODULE_NAME, desc = "Configuration commands.")
    cmd = CommandInfo(name = "show", desc = "Show configuration.")
    param = ParamInfo(name = "argument", type = "string", optional=True, desc = "If you specify the argument 'all' (before the identifier), recursively show all child elements for the given identifier.")
43
    cmd.add_param(param)
44
    param = ParamInfo(name = "identifier", type = "string", optional=True, desc = DEFAULT_IDENTIFIER_DESC)
45 46 47
    cmd.add_param(param)
    module.add_command(cmd)

48
    cmd = CommandInfo(name = "show_json", desc = "Show full configuration in JSON format.")
49
    param = ParamInfo(name = "identifier", type = "string", optional=True, desc = DEFAULT_IDENTIFIER_DESC)
50 51 52
    cmd.add_param(param)
    module.add_command(cmd)

53
    cmd = CommandInfo(name = "add", desc = "Add an entry to configuration list. If no value is given, a default value is added.")
54
    param = ParamInfo(name = "identifier", type = "string", optional=True, desc = DEFAULT_IDENTIFIER_DESC)
55
    cmd.add_param(param)
56
    param = ParamInfo(name = "value", type = "string", optional=True, desc = "Specifies a value to add to the list. It must be in correct JSON format and complete.")
57 58 59
    cmd.add_param(param)
    module.add_command(cmd)

60
    cmd = CommandInfo(name = "remove", desc = "Remove entry from configuration list.")
61
    param = ParamInfo(name = "identifier", type = "string", optional=True, desc = DEFAULT_IDENTIFIER_DESC)
62
    cmd.add_param(param)
63
    param = ParamInfo(name = "value", type = "string", optional=True, desc = "Specifies a value to remove from the list. It must be in correct JSON format and complete.")
64 65 66
    cmd.add_param(param)
    module.add_command(cmd)

67
    cmd = CommandInfo(name = "set", desc = "Set a configuration value.")
68
    param = ParamInfo(name = "identifier", type = "string", optional=True, desc = DEFAULT_IDENTIFIER_DESC)
69
    cmd.add_param(param)
70
    param = ParamInfo(name = "value", type = "string", optional=False, desc = "Specifies a value to set. It must be in correct JSON format and complete.")
71 72 73
    cmd.add_param(param)
    module.add_command(cmd)

74
    cmd = CommandInfo(name = "unset", desc = "Unset a configuration value (i.e. revert to the default, if any).")
75
    param = ParamInfo(name = "identifier", type = "string", optional=False, desc = DEFAULT_IDENTIFIER_DESC)
76 77 78
    cmd.add_param(param)
    module.add_command(cmd)

79
    cmd = CommandInfo(name = "diff", desc = "Show all local changes that have not been committed.")
80 81
    module.add_command(cmd)

82
    cmd = CommandInfo(name = "revert", desc = "Revert all local changes.")
83 84
    module.add_command(cmd)

85
    cmd = CommandInfo(name = "commit", desc = "Commit all local changes.")
86 87
    module.add_command(cmd)

88
    cmd = CommandInfo(name = "go", desc = "Go to a specific configuration part.")
89
    param = ParamInfo(name = "identifier", type="string", optional=False, desc = DEFAULT_IDENTIFIER_DESC)
90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
    cmd.add_param(param)
    module.add_command(cmd)

    tool.add_module_info(module)

def check_port(option, opt_str, value, parser):
    if (value < 0) or (value > 65535):
        raise OptionValueError('%s requires a port number (0-65535)' % opt_str)
    parser.values.port = value

def check_addr(option, opt_str, value, parser):
    ipstr = value
    ip_family = socket.AF_INET
    if (ipstr.find(':') != -1):
        ip_family = socket.AF_INET6

    try:
        socket.inet_pton(ip_family, ipstr)
    except:
        raise OptionValueError("%s invalid ip address" % ipstr)

    parser.values.addr = value

def set_bindctl_options(parser):
114 115 116
    parser.add_option('-p', '--port', dest='port', type='int',
                      action='callback', callback=check_port,
                      default='8080', help='port for cmdctl of bind10')
117

118 119 120
    parser.add_option('-a', '--address', dest='addr', type='string',
                      action='callback', callback=check_addr,
                      default='127.0.0.1', help='IP address for cmdctl of bind10')
121

122 123 124 125 126 127 128
    parser.add_option('-c', '--certificate-chain', dest='cert_chain',
                      type='string', action='store',
                      help='PEM formatted server certificate validation chain file')

    parser.add_option('--csv-file-dir', dest='csv_file_dir', type='string',
                      default=None, action='store',
                      help='Directory to store the password CSV file')
129 130

if __name__ == '__main__':
131 132 133 134
    parser = OptionParser(version = VERSION)
    set_bindctl_options(parser)
    (options, args) = parser.parse_args()
    server_addr = options.addr + ':' + str(options.port)
135 136
    tool = BindCmdInterpreter(server_addr, pem_file=options.cert_chain,
                              csv_file_dir=options.csv_file_dir)
137 138
    prepare_config_commands(tool)
    tool.run()