diff --git a/tools/crm.in b/tools/crm.in
index 7be886e56c..cd1d74fc57 100644
--- a/tools/crm.in
+++ b/tools/crm.in
@@ -1,3999 +1,3999 @@
 #!/usr/bin/env python
 #
 
 # Copyright (C) 2008 Dejan Muhamedagic <dmuhamedagic@suse.de>
 # 
 # This program is free software; you can redistribute it and/or
 # modify it under the terms of the GNU General Public
 # License as published by the Free Software Foundation; either
 # version 2.1 of the License, or (at your option) any later version.
 # 
 # This software is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 # General Public License for more details.
 # 
 # You should have received a copy of the GNU General Public
 # License along with this library; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 #
 
 import shlex
 import os
 from tempfile import mkstemp
 import subprocess
 import sys
 import time
 import readline
 import copy
 import xml.dom.minidom
 import signal
 import re
 
 class ErrorBuffer(object):
     '''
     Show error messages either immediately or buffered.
     '''
     def __init__(self):
         self.msg_list = []
         self.mode = "immediate"
     def buffer(self):
         self.mode = "keep"
     def release(self):
         if self.msg_list:
             print '\n'.join(self.msg_list)
             if interactive:
                 raw_input("Press enter to continue... ")
             self.msg_list = []
         self.mode = "immediate"
     def writemsg(self,msg):
         if self.mode == "immediate":
             print msg
         else:
             self.msg_list.append(msg)
     def error(self,s):
         self.writemsg("ERROR: %s" % s)
     def warning(self,s):
         self.writemsg("WARNING: %s" % s)
     def info(self,s):
         self.writemsg("INFO: %s" % s)
 
 def common_err(s):
     err_buf.error(s)
 def common_warn(s):
     err_buf.warning(s)
 def common_info(s):
     err_buf.info(s)
 def no_prog_err(name):
     err_buf.error("%s not available, check your installation"%name)
 def missing_prog_warn(name):
     err_buf.warning("could not find any %s on the system"%name)
 def no_attribute_err(attr,obj_type):
     err_buf.error("required attribute %s not found in %s"%(attr,obj_type))
 def bad_def_err(what,msg):
     err_buf.error("bad %s definition: %s"%(what,msg))
 def unsupported_err(name):
     err_buf.error("%s is not supported"%name)
 def no_such_obj_err(name):
     err_buf.error("%s object is not supported"%name)
 def obj_cli_err(name):
     err_buf.error("object %s cannot be represented in the CLI notation"%name)
 def missing_obj_err(node):
     err_buf.error("object %s:%s missing (shouldn't have happened)"% \
         (node.tagName,node.getAttribute("id")))
 def constraint_norefobj_err(constraint_id,obj_id):
     err_buf.error("constraint %s references a resource %s which doesn't exist"% \
         (constraint_id,obj_id))
 def obj_exists_err(name):
     err_buf.error("object %s already exists"%name)
 def no_object_err(name):
     err_buf.error("object %s does not exist"%name)
 def invalid_id_err(obj_id):
     err_buf.error("%s: invalid object id"%obj_id)
 def id_used_err(node_id):
     err_buf.error("%s: id is already in use"%node_id)
 def skill_err(s):
     err_buf.error("%s: this command is not allowed at this skill level"%' '.join(s))
 def syntax_err(s,token = '',context = ''):
     pfx = "syntax"
     if context:
         pfx = "%s in %s" %(pfx,context)
     if type(s) == type(''):
         err_buf.error("%s near <%s>"%(pfx,s))
     elif token:
         err_buf.error("%s near <%s>: %s"%(pfx,token,' '.join(s)))
     else:
         err_buf.error("%s: %s"%(pfx,' '.join(s)))
 def bad_attr_usage(cmd,args):
     err_buf.error("bad usage: %s %s"%(cmd,args))
 def cib_parse_err(msg):
     err_buf.error("%s"%msg)
 def cib_no_elem_err(el_name):
     err_buf.error("CIB contains no '%s' element!"%el_name)
 def cib_ver_unsupported_err(validator,rel):
     err_buf.error("CIB not supported: validator '%s', release '%s'"% (validator,rel))
     err_buf.error("You may try the upgrade command")
 def update_err(obj_id,cibadm_opt,node):
     if cibadm_opt == '-C':
         task = "create"
     elif cibadm_opt == '-D':
         task = "delete"
     else:
         task = "update"
     err_buf.error("could not %s %s"%(task,obj_id))
     err_buf.info("offending xml: %s" % node.toprettyxml())
 def not_impl_info(s):
     err_buf.info("%s is not implemented yet" % s)
 
 def ask(msg):
     ans = raw_input(msg + ' ')
     if not ans:
         return False
     return ans[0].lower() == 'y'
 
 from UserDict import DictMixin
 class odict(DictMixin):
     def __init__(self, data=None, **kwdata):
         self._keys = []
         self._data = {}
     def __setitem__(self, key, value):
         if key not in self._data:
             self._keys.append(key)
         self._data[key] = value
     def __getitem__(self, key):
         return self._data[key]
     def __delitem__(self, key):
         del self._data[key]
         self._keys.remove(key)
     def keys(self):
         return list(self._keys)
     def copy(self):
         copyDict = odict()
         copyDict._data = self._data.copy()
         copyDict._keys = self._keys[:]
         return copyDict
 
 def cmd_end(cmd):
     "Go up one level."
     levels.droplevel()
 def cmd_exit(cmd):
     "Quit"
     cmd_end(cmd)
     if interactive:
         print "bye"
     try:
         readline.write_history_file(hist_file)
     except:
         pass
     for f in tmpfiles:
         os.unlink(f)
     sys.exit()
 def dump_short_desc(help_tab):
     for topic in help_tab:
         if topic == '.':
             continue
         shortdesc = help_tab[topic][0]
         # with odict, for whatever reason, python parses differently:
         # help_tab["..."] = ("...","...") and
         # help_tab["..."] = ("...","""
         # ...""")
         # a parser bug?
         if type(help_tab[topic][0]) == type(()):
             shortdesc = help_tab[topic][0][0]
         print "\t",topic.ljust(16),shortdesc
 def cmd_help(help_tab,topic = ''):
     "help!"
     # help_tab is a dict: topic: (short_desc,long_desc)
     # '.' is a special entry for the top level
     if not topic:
         print ""
         print help_tab['.'][1]
         print ""
         print "Available commands:"
         print ""
         dump_short_desc(help_tab)
         print ""
         return
     if topic not in help_tab:
         print "There is no help for topic %s" % topic
         return
     if type(help_tab[topic][0]) == type(()):
         print help_tab[topic][0][1]
     else:
         print help_tab[topic][1]
 
 def add_sudo(cmd):
     if user_prefs.crm_user:
         return "sudo -E -u %s %s"%(user_prefs.crm_user,cmd)
     return cmd
 def pipe_string(cmd,s):
     cmd = add_sudo(cmd)
     try:
         p = os.popen(cmd,'w')
         p.write(s)
         return p.close()
     except IOError, msg:
         common_err(msg)
         return -1
 def xml2doc(cmd):
     cmd = add_sudo(cmd)
     try:
         p = os.popen(cmd,'r')
     except IOError, msg:
         common_err(msg)
         return None
     try:
         doc = xml.dom.minidom.parse(p)
     except xml.parsers.expat.ExpatError,msg:
         common_err("cannot parse output of %s: %s"%(cmd,msg))
         p.close()
         return None
     p.close()
     return doc
 #def pipe_string(cmd,s):
 #   'Run a program, collect and return stdout.'
 #   if user_prefs.crm_user:
 #       p = Popen3("sudo -E -u %s %s"%(user_prefs.crm_user,cmd), None)
 #   else:
 #       p = Popen3(cmd, None)
 #   p.fromchild.close()
 #   p.tochild.write(s)
 #   p.tochild.close()
 #   p.wait()
 
 def str2tmp(s):
     '''
     Write the given string to a temporary file. Return the name
     of the file.
     '''
     fd,tmp = mkstemp()
     try: f = os.fdopen(fd,"w")
     except IOError, msg:
         common_err(msg)
         return
     f.write(s)
     f.close()
     return tmp
 
 def ext_cmd(cmd):
     if os.system(add_sudo(cmd)) != 0:
         return False
     else:
         return True
 
 def is_program(prog):
     return os.system("which %s >/dev/null 2>&1"%prog) == 0
 def find_program(envvar,*args):
     if envvar and os.getenv(envvar):
         return os.getenv(envvar)
     for prog in args:
         if is_program(prog):
             return prog
 
 def is_id_valid(id):
     """
     Verify that the id follows the definition:
     http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-qualnames
     """
     if not id:
         return False
     id_re = "^[A-Za-z_][\w._-]*$"
     return re.match(id_re,id)
 def check_filename(fname):
     """
     Verify that the string is a filename.
     """
     fname_re = "^[^/]+$"
     return re.match(fname_re,id)
 
 class UserPrefs(object):
     '''
     Keep user preferences here.
     '''
     def __init__(self):
         self.skill_level = 2 #TODO: set back to 0?
         self.editor = find_program("EDITOR","vim","vi","emacs","nano")
         self.pager = find_program("PAGER","less","more","pg")
         self.dotty = find_program("","dotty")
         if not self.editor:
             missing_prog_warn("editor")
         if not self.pager:
             missing_prog_warn("pager")
         self.crm_user = ""
         self.xmlindent = "  "  # two spaces
     def check_skill_level(self,n):
         return self.skill_level >= n
 
 class CliOptions(object):
     '''
     Manage user preferences
     '''
     skill_levels = {"operator":0, "administrator":1, "expert":2}
     help_table = odict()
     help_table["."] = ("user preferences","Various user preferences may be set here.")
     help_table["skill-level"] = ("set skill level", "")
     help_table["editor"] = ("set prefered editor program", "")
     help_table["pager"] = ("set prefered pager program", "")
     help_table["user"] = ("set the cluster user", """
 If you need extra privileges to talk to the cluster (i.e. the cib
 process), then set this to user. Typically, that is either "root"
 or "hacluster". Don't forget to setup the sudoers file as well.
 
 Example: user hacluster
 """)
     help_table["help"] = ("show help", "")
     help_table["end"] = ("go back one level", "")
     def __init__(self):
         self.cmd_table = {
             "skill-level": (self.set_skill_level,(1,1),0,(skills_list,)),
             "editor": (self.set_editor,(1,1),0),
             "pager": (self.set_pager,(1,1),0),
             "user": (self.set_crm_user,(0,1),0),
             "save": (self.save_options,(0,0),0),
             "show": (self.show_options,(0,0),0),
             "help": (self.help,(0,1),0),
             "quit": (cmd_exit,(0,0),0),
             "end": (cmd_end,(0,0),0),
         }
     def set_skill_level(self,cmd,skill_level):
         """usage: skill-level <level>
         level: operator | administrator | expert"""
         if skill_level in self.skill_levels:
             user_prefs.skill_level = self.skill_levels[skill_level]
         else:
             common_err("no %s skill level"%skill_level)
             return False
     def get_skill_level(self):
         for s in self.skill_levels:
             if user_prefs.skill_level == self.skill_levels[s]:
                 return s
     def set_editor(self,cmd,prog):
         "usage: editor <program>"
         if is_program(prog):
             user_prefs.editor = prog
         else:
             common_err("program %s does not exist"% prog)
             return False
     def set_pager(self,cmd,prog):
         "usage: pager <program>"
         if is_program(prog):
             user_prefs.pager = prog
         else:
             common_err("program %s does not exist"% prog)
             return False
     def set_crm_user(self,cmd,user = ''):
         "usage: user [<crm_user>]"
         user_prefs.crm_user = user
     def write_rc(self,f):
         print >>f, '%s "%s"' % ("editor",user_prefs.editor)
         print >>f, '%s "%s"' % ("pager",user_prefs.pager)
         print >>f, '%s "%s"' % ("user",user_prefs.crm_user)
         print >>f, '%s "%s"' % ("skill-level",self.get_skill_level())
     def show_options(self,cmd):
         "usage: show"
         self.write_rc(sys.stdout)
     def save_options(self,cmd):
         "usage: save"
         try: f = open(rc_file,"w")
         except os.error,msg:
             common_err("open: %s"%msg)
             return
         print >>f, 'options'
         self.write_rc(f)
         print >>f, 'end'
         f.close()
     def help(self,cmd,topic = ''):
         "usage: help [<topic>]"
         cmd_help(self.help_table,topic)
 
 cib_dump = "cibadmin -Ql"
 cib_piped = "cibadmin -p"
 cib_upgrade = "cibadmin --upgrade --force"
 cib_verify = "crm_verify -V -p"
 
 class WCache(object):
     "Cache stuff. A naive implementation."
     def __init__(self):
         self.lists = {}
         self.stamp = time.time()
         self.max_cache_age = 60 # seconds
     def is_cached(self,name):
         if time.time() - self.stamp > self.max_cache_age:
             self.stamp = time.time()
             self.clear()
         return name in self.lists
     def store(self,name,lst):
         self.lists[name] = lst
         return lst
     def retrieve(self,name):
         if self.is_cached(name):
             return self.lists[name]
         else:
             return None
     def clear(self):
         self.lists = {}
 
 class CibShadow(object):
     '''
     CIB shadow management class
     '''
     help_table = odict()
     help_table["."] = ("","""
 CIB shadow management.
 See the crm_shadow program.
 """)
     help_table["new"] = ("create a new shadow CIB", "")
     help_table["delete"] = ("delete a shadow CIB", "")
     help_table["reset"] = ("copy live cib to a shadow CIB", "")
     help_table["commit"] = ("copy a shadow CIB to the cluster", "")
     help_table["use"] = ("change working CIB", '''
 Choose a shadow CIB for further changes. If the name
 provided is empty, then the live (cluster) CIB is used.
 ''')
     help_table["diff"] = ("diff between the shadow CIB and the live CIB", "")
     help_table["list"] = ("list all shadow CIBs", "")
     help_table["quit"] = ("exit the program", "")
     help_table["help"] = ("show help", "")
     help_table["end"] = ("go back one level", "")
     envvar = "CIB_shadow"
     extcmd = ">/dev/null </dev/null crm_shadow"
     def __init__(self):
         self.cmd_table = {
             "new": (self.new,(1,2),1),
             "delete": (self.delete,(1,1),1),
             "reset": (self.reset,(1,1),1),
             "commit": (self.commit,(1,1),1),
             "use": (self.use,(0,1),1),
             "diff": (self.diff,(0,0),1),
             "list": (self.list,(0,0),1),
             "help": (self.help,(0,1),0),
             "quit": (cmd_exit,(0,0),0),
             "end": (cmd_end,(0,0),0),
         }
         self.chkcmd()
     def chkcmd(self):
         try:
             os.system("%s 2>&1" % self.extcmd)
         except os.error:
             no_prog_err(self.extcmd)
             return False
         return True
     def new(self,cmd,name,force = ''):
         "usage: new <shadow_cib> [force]"
         new_cmd = "%s -c '%s'" % (self.extcmd,name)
         if force:
             if force == "force" or force == "--force":
                 new_cmd = "%s --force" % new_cmd
             else:
                 syntax_err((new_cmd,force), context = 'new')
                 return False
         if ext_cmd(new_cmd):
             common_info("%s shadow CIB created"%name)
             self.use("use",name)
     def delete(self,cmd,name):
         "usage: delete <shadow_cib>"
         if cib_in_use == name:
             common_err("%s shadow CIB is in use"%name)
             return False
         if ext_cmd("%s -D '%s' --force" % (self.extcmd,name)):
             common_info("%s shadow CIB deleted"%name)
         else:
             common_err("failed to delete %s shadow CIB"%name)
             return False
     def reset(self,cmd,name):
         "usage: reset <shadow_cib>"
         if ext_cmd("%s -r '%s'" % (self.extcmd,name)):
             common_info("copied live CIB to %s"%name)
         else:
             common_err("failed to copy live CIB to %s"%name)
             return False
     def commit(self,cmd,name):
         "usage: commit <shadow_cib>"
         if ext_cmd("%s -C '%s' --force" % (self.extcmd,name)):
             common_info("commited '%s' shadow CIB to the cluster"%name)
         else:
             common_err("failed to commit the %s shadow CIB"%name)
             return False
     def diff(self,cmd):
         "usage: diff"
         return ext_cmd("%s -d" % self.extcmd)
     def list(self,cmd):
         "usage: list"
         return ext_cmd("ls @HA_VARLIBDIR@/heartbeat/crm | fgrep shadow. | sed 's/^shadow\.//'")
     def use(self,cmd,name = ''):
         "usage: use [<shadow_cib>]"
         # Choose a shadow cib for further changes. If the name
         # provided is empty, then choose the live (cluster) cib.
         # FIXME: should we check name's sanity?
         global cib_in_use
         if not name or name == "live":
             name = ""
             os.unsetenv(self.envvar)
         else:
             if not ext_cmd("test -r '@HA_VARLIBDIR@/heartbeat/crm/shadow.%s'"%name):
                 common_err("%s: no such shadow CIB"%name)
                 return False
             os.putenv(self.envvar,name)
         cib_in_use = name
     def help(self,cmd,topic = ''):
         cmd_help(self.help_table,topic)
 
 def manage_attr(cmd,attr_ext_commands,*args):
     if len(args) < 3:
         bad_attr_usage(cmd,' '.join(args))
         return False
     attr_cmd = None
     try:
         attr_cmd = attr_ext_commands[args[1]]
     except KeyError:
         bad_attr_usage(cmd,' '.join(args))
         return False
     if not attr_cmd:
         bad_attr_usage(cmd,' '.join(args))
         return False
     if args[1] == 'set':
         if len(args) == 4:
             return ext_cmd(attr_cmd%(args[0],args[2],args[3]))
         else:
             bad_attr_usage(cmd,' '.join(args))
             return False
     elif args[1] in ('delete','show'):
         if len(args) == 3:
             return ext_cmd(attr_cmd%(args[0],args[2]))
         else:
             bad_attr_usage(cmd,' '.join(args))
             return False
     else:
         bad_attr_usage(cmd,' '.join(args))
         return False
 
 def is_rsc_running(id):
     if not id: return False
     proc = subprocess.Popen(RscMgmt.rsc_status % id, \
         shell=True, stdout=subprocess.PIPE)
     outp = proc.communicate()[0]
     return outp.find("running") > 0 and outp.find("NOT") == -1
 def is_process(s):
     proc = subprocess.Popen("ps -e -o pid,command | grep -qs '%s'" % s, \
         shell=True, stdout=subprocess.PIPE)
     proc.wait()
     return proc.returncode == 0
 def cluster_stack():
     if is_process("heartbeat:.[m]aster"):
         return "heartbeat"
     elif is_process("[a]isexec"):
         return "openais"
     return ""
 
 class RscMgmt(object):
     '''
     Resources management class
     '''
     rsc_status_all = "crm_resource -L"
     rsc_status = "crm_resource -W -r '%s'"
     rsc_startstop = "crm_resource --meta -r '%s' -p target-role -v '%s'"
     rsc_manage = "crm_resource --meta -r '%s' -p is-managed -v '%s'"
     rsc_migrate = "crm_resource -M -r '%s'"
     rsc_migrateto = "crm_resource -M -r '%s' -H '%s'"
     rsc_unmigrate = "crm_resource -U -r '%s'"
     rsc_cleanup = "crm_resource -C -r '%s' -H '%s'"
     rsc_param =  {
         'set': "crm_resource -r '%s' -p '%s' -v '%s'",
         'delete': "crm_resource -r '%s' -d '%s'",
         'show': "crm_resource -r '%s' -g '%s'",
     }
     rsc_meta =  {
         'set': "crm_resource --meta -r '%s' -p '%s' -v '%s'",
         'delete': "crm_resource --meta -r '%s' -d '%s'",
         'show': "crm_resource --meta -r '%s' -g '%s'",
     }
     rsc_failcount = {
         'set': "crm_failcount -r '%s' -U '%s' -v '%s'",
         'delete': "crm_failcount -r '%s' -U '%s' -D",
         'show': "crm_failcount -r '%s' -U '%s' -G",
     }
     rsc_refresh = "crm_resource -R"
     rsc_refresh_node = "crm_resource -R -H '%s'"
     rsc_reprobe = "crm_resource -P"
     rsc_reprobe_node = "crm_resource -P -H '%s'"
     help_table = odict()
     help_table["."] = ("","Resource management.")
     help_table["status"] = ("show status of resources", "")
     help_table["start"] = ("start a resource", "")
     help_table["stop"] = ("stop a resource", "")
     help_table["manage"] = ("put a resource into managed mode", "")
     help_table["unmanage"] = ("put a resource into unmanaged mode", "")
     help_table["migrate"] = ("migrate a resource to another node", "")
     help_table["unmigrate"] = ("migrate a resource to its prefered node", "")
     help_table["param"] = ("manage a parameter of a resource","""
 Manage or display a parameter of a resource (also known as an
 instance_attribute).
 
 Usage:
 
         param <rsc> set <param> <value>
         param <rsc> delete <param>
         param <rsc> show <param>
 
 Example:
 
         param ip_0 show ip
 """)
     help_table["meta"] = ("manage a meta attribute","""
 Show/edit/delete a meta attribute of a resource. Currently, all
 meta attributes of a resource may be managed with other commands
 such as 'resource stop'.
 
 Usage:
 
         meta <rsc> set <attr> <value>
         meta <rsc> delete <attr>
         meta <rsc> show <attr>
 
 Example:
 
         meta ip_0 set target-role stopped
 """)
     help_table["failcount"] = ("manage failcounts", """
 Show/edit/delete the failcount of a resource.
 
 Usage:
 
         failcount <rsc> set <node> <value>
         failcount <rsc> delete <node>
         failcount <rsc> show <node>
 
 Example:
 
         failcount fs_0 delete node2
 """)
     help_table["cleanup"] = ("cleanup resource status","")
     help_table["refresh"] = ("refresh CIB from the LRM status","")
     help_table["reprobe"] = ("probe for resources not started by the CRM","")
     help_table["quit"] = ("exit the program", "")
     help_table["help"] = ("show help", "")
     help_table["end"] = ("go back one level", "")
     def __init__(self):
         self.cmd_table = {
             "status": (self.status,(0,1),0,(rsc_list,)),
             "start": (self.start,(1,1),0,(rsc_list,)),
             "stop": (self.stop,(1,1),0,(rsc_list,)),
             "manage": (self.manage,(1,1),0,(rsc_list,)),
             "unmanage": (self.unmanage,(1,1),0,(rsc_list,)),
             "migrate": (self.migrate,(1,2),0,(rsc_list,listnodes)),
             "unmigrate": (self.unmigrate,(1,1),0,(rsc_list,)),
             "param": (self.param,(3,4),1,(rsc_list,attr_cmds)),
             "meta": (self.meta,(3,4),1,(rsc_list,attr_cmds)),
             "failcount": (self.failcount,(3,4),0,(rsc_list,attr_cmds,listnodes)),
             "cleanup": (self.cleanup,(1,2),1,(rsc_list,listnodes)),
             "refresh": (self.refresh,(0,1),0,(listnodes,)),
             "reprobe": (self.reprobe,(0,1),0,(listnodes,)),
             "help": (self.help,(0,1),0),
             "quit": (cmd_exit,(0,0),0),
             "end": (cmd_end,(0,0),0),
         }
     def status(self,cmd,rsc = None):
         "usage: status [<rsc>]"
         if rsc:
             return ext_cmd(self.rsc_status % rsc)
         else:
             return ext_cmd(self.rsc_status_all)
     def start(self,cmd,rsc):
         "usage: start <rsc>"
         return ext_cmd(self.rsc_startstop%(rsc,"Started"))
     def stop(self,cmd,rsc):
         "usage: stop <rsc>"
         return ext_cmd(self.rsc_startstop%(rsc,"Stopped"))
     def manage(self,cmd,rsc):
         "usage: manage <rsc>"
         return ext_cmd(self.rsc_manage%(rsc,"true"))
     def unmanage(self,cmd,rsc):
         "usage: unmanage <rsc>"
         return ext_cmd(self.rsc_manage%(rsc,"false"))
     def migrate(self,cmd,*args):
         """usage: migrate <rsc> [<node>]"""
         if len(args) == 1:
             return ext_cmd(self.rsc_migrate%args[0])
         else:
             return ext_cmd(self.rsc_migrateto%(args[0],args[1]))
     def unmigrate(self,cmd,rsc):
         "usage: unmigrate <rsc>"
         return ext_cmd(self.rsc_unmigrate%rsc)
     def cleanup(self,cmd,*args):
         "usage: cleanup <node>"
         # Cleanup a resource on a node. Omit node to cleanup on
         # all live nodes.
         if len(args) == 2: # remove
             return ext_cmd(self.rsc_cleanup%(args[0],args[1]))
         else:
             rv = True
             for n in listnodes():
                 if not ext_cmd(self.rsc_cleanup%(args[0],n)):
                     rv = False
             return rv
     def failcount(self,cmd,*args):
         """usage:
         failcount <rsc> set <node> <value>
         failcount <rsc> delete <node>
         failcount <rsc> show <node>"""
         d = lambda: manage_attr(cmd,self.rsc_failcount,*args)
         return d()
     def param(self,cmd,*args):
         """usage:
         param <rsc> set <param> <value>
         param <rsc> delete <param>
         param <rsc> show <param>"""
         d = lambda: manage_attr(cmd,self.rsc_param,*args)
         return d()
     def meta(self,cmd,*args):
         """usage:
         meta <rsc> set <attr> <value>
         meta <rsc> delete <attr>
         meta <rsc> show <attr>"""
         d = lambda: manage_attr(cmd,self.rsc_meta,*args)
         return d()
     def refresh(self,cmd,*args):
         'usage: refresh [<node>]'
         if len(args) == 1:
             return ext_cmd(self.rsc_refresh_node%args[0])
         else:
             return ext_cmd(self.rsc_refresh)
     def reprobe(self,cmd,*args):
         'usage: reprobe [<node>]'
         if len(args) == 1:
             return ext_cmd(self.rsc_reprobe_node%args[0])
         else:
             return ext_cmd(self.rsc_reprobe)
     def help(self,cmd,topic = ''):
         cmd_help(self.help_table,topic)
 
 def print_node(uname,id,type,other,inst_attr):
     """
     Try to pretty print a node from the cib. Sth like:
     uname(id): type
         attr1: v1
         attr2: v2
     """
     if uname == id:
         print "%s: %s" % (uname,type)
     else:
         print "%s(%s): %s" % (uname,id,type)
     for a in other:
         print "\t%s: %s" % (a,other[a])
     for a,v in inst_attr:
         print "\t%s: %s" % (a,v)
 class NodeMgmt(object):
     '''
     Nodes management class
     '''
     node_standby = "crm_standby -U '%s' -v '%s'"
     node_delete = "cibadmin -D -o nodes -X '<node uname=\"%s\"/>'"
     hb_delnode = "@hb_libdir@/hb_delnode '%s'"
     dc = "crmadmin -D"
     node_attr = {
         'set': "crm_attribute -t nodes -U '%s' -n '%s' -v '%s'",
         'delete': "crm_attribute -D -t nodes -U '%s' -n '%s'",
         'show': "crm_attribute -G -t nodes -U '%s' -n '%s'",
     }
     node_status = {
         'set': "crm_attribute -t status -U '%s' -n '%s' -v '%s'",
         'delete': "crm_attribute -D -t status -U '%s' -n '%s'",
         'show': "crm_attribute -G -t status -U '%s' -n '%s'",
     }
     help_table = odict()
     help_table["."] = ("","Nodes management.")
     help_table["show"] = ("show node", "")
     help_table["standby"] = ("put node into standby", "")
     help_table["online"] = ("bring node online", "")
     help_table["delete"] = ("delete node", "")
     help_table["attribute"] = ("manage attributes", """
 Edit node attributes. This kind of attribute should refer to
 relatively static properties, such as memory size.
 
 Usage:
 
         attribute <node> set <attr> <value>
         attribute <node> delete <attr>
         attribute <node> show <attr>
 
 Example:
 
         attribute node_1 set memory_size 4096
 """)
     help_table["status-attr"] = ("manage status attributes", """
 Edit node attributes which are in the CIB status section, i.e.
 attributes which hold properties of a more volatile nature. One
 typical example is attribute generated by the 'pingd' utility.
 
 Usage:
 ...............
         status-attr <node> set <attr> <value>
         status-attr <node> delete <attr>
         status-attr <node> show <attr>
 ...............
 Example:
 ...............
         status-attr node_1 show pingd
 """)
     help_table["quit"] = ("exit the program", "")
     help_table["help"] = ("show help", "")
     help_table["end"] = ("go back one level", "")
     def __init__(self):
         self.cmd_table = {
             "status": (self.status,(0,1),0,(listnodes,)),
             "show": (self.show,(0,1),0,(listnodes,)),
             "standby": (self.standby,(1,1),0,(listnodes,)),
             "online": (self.online,(1,1),0,(listnodes,)),
             "delete": (self.delete,(1,1),0,(listnodes,)),
             "attribute": (self.attribute,(3,4),0,(listnodes,attr_cmds)),
             "status-attr": (self.status_attr,(3,4),0,(listnodes,attr_cmds)),
             "help": (self.help,(0,1),0),
             "quit": (cmd_exit,(0,0),0),
             "end": (cmd_end,(0,0),0),
         }
     def status(self,cmd,node = None):
         'usage: status [<node>]'
         return ext_cmd("%s -o nodes"%cib_dump)
     def show(self,cmd,node = None):
         'usage: show [<node>]'
         doc = xml2doc("%s -o nodes"%cib_dump)
         if not doc:
             return False
         nodes_node = get_cib_elem(doc, "nodes")
         if not nodes_node:
             return False
         for c in nodes_node.childNodes:
             if not is_element(c) or c.tagName != "node":
                 continue
             if node and c.getAttribute("uname") != node:
                 continue
             type = uname = id = ""
             other = inst_attr = []
             for attr in c.attributes.keys():
                 v = c.getAttribute(attr)
                 if attr == "type":
                     type = v
                 elif attr == "uname":
                     uname = v
                 elif attr == "id":
                     id = v
                 else:
                     other[attr] = v
             for c2 in c.childNodes:
                 if not is_element(c2):
                     continue
                 if c2.tagName == "instance_attributes":
                     inst_attr = nvpairs2list(c2)
             print_node(uname,id,type,other,inst_attr)
     def standby(self,cmd,node):
         'usage: standby <node>'
         return ext_cmd(self.node_standby%(node,"on"))
     def online(self,cmd,node):
         'usage: online <node>'
         return ext_cmd(self.node_standby%(node,"off"))
     def delete(self,cmd,node):
         'usage: delete <node>'
         rv = True
         if cluster_stack() == "heartbeat":
             rv = ext_cmd(self.hb_delnode%node)
         if rv:
             rv = ext_cmd(self.node_delete%node)
         return rv
     def attribute(self,cmd,*args):
         """usage:
-        attribute <rsc> set <node> <value>
-        attribute <rsc> delete <node>
-        attribute <rsc> show <node>"""
+        attribute <node> set <rsc> <value>
+        attribute <node> delete <rsc>
+        attribute <node> show <rsc>"""
         d = lambda: manage_attr(cmd,self.node_attr,*args)
         return d()
     def status_attr(self,cmd,*args):
         """usage:
-        status-attr <rsc> set <node> <value>
-        status-attr <rsc> delete <node>
-        status-attr <rsc> show <node>"""
+        status-attr <node> set <rsc> <value>
+        status-attr <node> delete <rsc>
+        status-attr <node> show <rsc>"""
         d = lambda: manage_attr(cmd,self.node_status,*args)
         return d()
     def help(self,cmd,topic = ''):
         cmd_help(self.help_table,topic)
 
 def edit_file(fname):
     'Edit a file.'
     if not fname:
         return
     if not user_prefs.editor:
         return
     return os.system("%s %s" % (user_prefs.editor,fname))
 
 def page_string(s):
     'Write string through a pager.'
     if not s:
         return
     if not user_prefs.pager or not interactive:
         print s
     else:
         pipe_string(user_prefs.pager,s)
 
 def lines2cli(s):
     '''
     Convert a string into a list of lines. Replace continuation
     characters. Strip white space, left and right. Drop empty lines.
     '''
     cl = []
     l = s.split('\n')
     cum = []
     for p in l:
         p = p.strip()
         if p.endswith('\\'):
             p = p.rstrip('\\')
             cum.append(p)
         else:
             cum.append(p)
             cl.append(''.join(cum).strip())
             cum = []
     if cum: # in case s ends with backslash
         cl.append(''.join(cum))
     return [x for x in cl if x]
 
 class CibConfig(object):
     '''
     The configuration class
     '''
     help_table = odict()
     help_table["."] = ("","CIB configuration.")
     help_table["verify"] = ("verify the CIB before commit", "Verify the CIB (before commit)")
     help_table["erase"] = ("erase the CIB", "Erase the CIB (careful!).")
     help_table["ptest"] = ("show cluster actions if changes were committed", """
 Show PE (policy engine) motions using ptest.
 
 A CIB is constructed using the current user edited version and
 the status from the current CIB. This CIB is run through ptest
 to show changes. If you have graphviz installed and X11 session,
 dotty is run to display the changes graphically.
 """)
     help_table["refresh"] = ("refresh from CIB", """
 Load the CIB from scratch. All changes are lost. The user is
 asked for confirmation beforehand
 """)
     help_table["show"] = ("display CIB objects", """
 The `show` command displays objects. It may display all objects
 or a set of objects. Specify 'changed' to see what changed.
 
 Usage:
 ...............
         show [xml] [<id> ...]
         show [xml] changed
 ...............
 """)
     help_table["edit"] = ("edit CIB objects", """
 This command invokes the editor with the object description. As
 with the `show` command, the user may choose to edit all objects
 or a set of objects.
 If the user insists, he or she may edit the XML edition of the
 object.
 
 Usage:
 ...............
         edit [xml] [<id> ...]
         edit [xml] changed
 ...............
 """)
     help_table["delete"] = ("delete CIB objects", """
 The user may delete one or more objects by specifying a list of
 ids. If the object to be deleted belongs to a container object,
 such as group, and it is the only resource in that container,
 then the container is deleted as well.
 
 Usage:
 ...............
         delete <id> [<id> ...]
 ...............
 """)
     help_table["rename"] = ("rename a CIB object", """
 Rename an object. It is recommended to use this command to rename
 a resource, because it will take care of updating all related
 constraints. Changing ids with the edit command won't have the
 same effect.
 
 If you want to rename a resource, it must be stopped.
 
 Usage:
 ...............
         rename <old_id> <new_id>
 ...............
 """)
     help_table["save"] = ("save the CIB to a file", """
 Save the configuration to a file. Optionally, as XML.
 
 Usage:
 ...............
         save [xml] <file>
 ...............
 Example:
 ...............
         save myfirstcib.txt
 ...............
 """)
     help_table["load"] = ("import the CIB from a file", """
 Load a part of configuration (or all of it) from a local file or
 a network URL. The `replace` method replaces the current
 configuration with the one from the source. The `update` tries to
 import the contents into the current configuration.  The file may
 be a CLI file or an XML file.
 
 Usage:
 ...............
         load [xml] method URL
 
         method :: replace | update
 ...............
 Example:
 ...............
         load xml replace myfirstcib.xml
         load xml replace http://storage.big.com/cibs/bigcib.xml
 ...............
 """)
     help_table["template"] = ("edit and import a configuration from a template", """
 The specified template is loaded into the editor. It's up to the
 user to make a good CRM configuration out of it.
 
 Usage:
 ...............
         template [xml] url
 ...............
 Example:
 ...............
         template two-apaches.txt
 ...............
 """)
     help_table["enter"] = ("enter the interactive configuration mode", """
 Those who prefer more typing, or in case the definition of a
 resource is rather long, the 'enter' command offers configuration
 in small steps.
 
 Usage:
 ...............
         enter <obj_type> <id>
 ...............
 Example:
 ...............
         enter primitive ip_1
 ...............
 """)
     help_table["commit"] = ("commit the changes to the CIB", """
 The changes at the configure level are not immediately applied to
 the CIB, but by this command or on exiting the configure level.
 Sometimes, the program will refuse to apply the changes, usually
 for good reason. If you know what you're doing, you may say
 'commit force' to force the changes.
 """)
     help_table["upgrade"] = ("upgrade the CIB to version 1.0", """
 If you get the "CIB not supported" error, which typically means
 that the current CIB version is coming from the older release,
 you may try to upgrade it to the latest revision. The command
 used is:
 
     cibadmin --upgrade --force
 
 If we don't recognize the current CIB as the old one, but you're
 sure that it is, you may force the command.
 
 Usage:
 ...............
         upgrade [force]
 ...............
 """)
     help_table["primitive"] = ("define a resource", """
 The primitive command describes a resource.
 
 Usage:
 ...............
         primitive <rsc> [<class>:[<provider>:]]<type>
           [params <param>=<value> [<param>=<value>...]]
           [meta <attribute>=<value> [<attribute>=<value>...]]
           [operations id_spec
             [op op_type [<attribute>=<value>...] ...]]
 
         id_spec :: $id=<id> | $id-ref=<id>
         op_type :: start | stop | monitor
 ...............
 Example:
 ...............
         primitive apcfence stonith:apcsmart \\
           params ttydev=/dev/ttyS0 hostlist="node1 node2" \\
           op start timeout=60s \\
           op monitor interval=30m timeout=60s
 
         primitive www8 apache \\
           params configfile=/etc/apache/www8.conf \\
           operations $id-ref=apache_ops
 ...............
 """)
     help_table["group"] = ("define a group", """
 The `group` command creates a group of resources.
 
 Usage:
 ...............
         group <name> <rsc> [<rsc>...]
           [params <param>=<value> [<param>=<value>...]]
           [meta <attribute>=<value> [<attribute>=<value>...]]
 ...............
 Example:
 ...............
         group internal_www disk0 fs0 internal_ip apache \\
           meta target-role=stopped
 ...............
 """)
     help_table["clone"] = ("define a clone", """
 The `clone` command creates a resource clone. It may contain a
 single primitive resource or one group of resources.
 
 Usage:
 ...............
         clone <name> <rsc>
           [params <param>=<value> [<param>=<value>...]]
           [meta <attribute>=<value> [<attribute>=<value>...]]
 ...............
 Example:
 ...............
         clone cl_fence apc_1 \\
           meta clone-node-max=1 globally-unique=false
 ...............
 """)
     help_table["ms"] = ("define a master-slave resource", """
 The `ms` command creates a master/slave resource type. It may contain a
 single primitive resource or one group of resources.
 
 Usage:
 ...............
         ms <name> <rsc>
           [params <param>=<value> [<param>=<value>...]]
           [meta <attribute>=<value> [<attribute>=<value>...]]
 ...............
 Example:
 ...............
         ms disk1 drbd1 \\
           meta notify=true globally-unique=false
 ...............
 """)
     help_table["location"] = ("a location preference", """
 `location` defines the preference of nodes for the given
 resource. The location constraints consist of one or more rules
 which specify a score to be awarded if the rule matches.
 
 Usage:
 ...............
         location <id> <rsc> {node_pref|rules}
 
         node_pref :: <score>: <node>
 
         rules ::
           rule [id_spec] [$role=<role>] <score>: <expression>
           [rule [id_spec] [$role=<role>] <score>: <expression> ...]
 
         id_spec :: $id=<id> | $id-ref=<id>
         score :: <number> | <attribute> | [-]inf
         expression :: <single_exp> [bool_op <simple_exp> ...]
                       | <date_expr>
         bool_op :: or | and
         single_exp :: <attribute> [type:]<binary_op> <value>
                       | <unary_op> <attribute>
         type :: string | version | number
         binary_op :: lt | gt | lte | gte | eq | ne
         unary_op :: defined | not_defined
 
         date_expr :: date_op <start> [<end>]  (TBD)
 ...............
 Examples:
 ...............
         location conn_1 internal_www 100: node1
 
         location conn_1 internal_www \\
           rule 100: #uname eq node1 \\
           rule pingd: defined pingd
 
         location conn_2 dummy_float \\
           rule -inf: not_defined pingd or pingd lte 0
 ...............
 """)
     help_table["colocation"] = ("colocate resources", """
 This constraint expresses the placement relation between two
 resources.
 
 Usage:
 ...............
         colocation <id> <score>: <rsc>[:<role>] <rsc>[:<role>]
 ...............
 Example:
 ...............
         colocation dummy_and_apache -inf: apache dummy
 ...............
 """)
     help_table["order"] = ("order resources", """
 This constraint expresses the order of actions on two resources.
 
 Usage:
 ...............
         order <id> score-type: <first-rsc>[:<action>] <then-rsc>[:<action>]
           [symmetrical=<bool>]
 
         score-type :: advisory | mandatory | <score>
 ...............
 Example:
 ...............
         order c_apache_1 mandatory: apache:start ip_1
 ...............
 """)
     help_table["property"] = ("set a cluster property", """
 Set the cluster (`crm_config`) options.
 
 Usage:
 ...............
         property [$id=<set_id>]
             <option>=<value> [<option>=<value>...]
 ...............
 Example:
 ...............
         property stonith-enabled=true
 ...............
 """)
     help_table["quit"] = ("exit the program", "")
     help_table["help"] = ("show help", "")
     help_table["end"] = ("go back one level", "")
     def __init__(self):
         self.cmd_table = {
             "erase": (self.erase,(0,0),1),
             "verify": (self.verify,(0,0),1),
             "refresh": (self.refresh,(0,0),1),
             "ptest": (self.ptest,(0,0),1),
             "commit": (self.commit,(0,1),1),
             "upgrade": (self.upgrade,(0,1),1),
             "show": (self.show,(0,),1,(id_list_xml,id_list,loop)),
             "edit": (self.edit,(0,),1,(id_list_xml,id_list,loop)),
             "delete": (self.delete,(1,),1,(id_list,loop)),
             "rename": (self.rename,(2,2),1,(id_list,)),
             "save": (self.save,(1,2),1),
             "load": (self.load,(2,3),1),
             "template": (self.template,(1,2),1),
             "enter": (self.enter,(2,2),1),
             "primitive": (self.conf_primitive,(2,),1),
             "group": (self.conf_group,(2,),1,(null_list,f_prim_id_list,loop)),
             "clone": (self.conf_clone,(2,),1,(null_list,f_children_id_list)),
             "ms": (self.conf_ms,(2,),1,(null_list,f_children_id_list)),
             "location": (self.conf_location,(2,),1,(null_list,rsc_id_list)),
             "colocation": (self.conf_colocation,(2,),1,(null_list,null_list,rsc_id_list,rsc_id_list)),
             "order": (self.conf_order,(2,),1,(null_list,null_list,rsc_id_list,rsc_id_list)),
             "property": (self.conf_property,(1,),1,(property_list,)),
             "help": (self.help,(0,1),1),
             "end": (self.end,(0,0),1),
             "quit": (self.exit,(0,0),1),
             "_test": (self.check_structure,(0,0),1),
         }
         if not build_completions:
             cib_factory.initialize()
     def check_structure(self,cmd):
         return cib_factory.check_structure()
     def _mkset_obj(self,*args):
         if args and args[0] == "xml":
             obj = lambda: CibObjectSetRaw(*args[1:])
         else:
             obj = lambda: CibObjectSetCli(*args)
         return obj()
     def show(self,cmd,*args):
         "usage: show [xml] [<id>...]"
         set_obj = self._mkset_obj(*args)
         set_obj.show()
     def edit(self,cmd,*args):
         "usage: edit [xml] [<id>...]"
         set_obj = self._mkset_obj(*args)
         set_obj.edit()
     def verify(self,cmd):
         "usage: verify"
         set_obj = self._mkset_obj("xml")
         set_obj.verify()
     def save(self,cmd,*args):
         "usage: save [xml] <filename>"
         if args[0] == "xml":
             f = args[1]
             set_obj = self._mkset_obj("xml")
         else:
             f = args[0]
             set_obj = self._mkset_obj()
         #FIXME: sanitize user input
         return set_obj.save_to_file(f)
     def load(self,cmd,*args):
         "usage: load [xml] {replace|update} {<url>|<path>}"
         if args[0] == "xml":
             url = args[2]
             method = args[1]
             set_obj = self._mkset_obj("xml","NOOBJ")
         else:
             url = args[1]
             method = args[0]
             set_obj = self._mkset_obj("NOOBJ")
         set_obj.import_file(method,url)
     def template(self,cmd,*args):
         "usage: template [xml] {<url>|<path>}"
         if batch:
             common_info("template not allowed in batch mode")
             return
         if args[0] == "xml":
             url = args[1]
             set_obj = self._mkset_obj("xml","NOOBJ")
         else:
             url = args[0]
             set_obj = self._mkset_obj("NOOBJ")
         set_obj.import_template(url)
     def delete(self,cmd,*args):
         "usage: delete <id> [<id>...]"
         return cib_factory.delete(*args)
     def rename(self,cmd,old_id,new_id):
         "usage: rename <old_id> <new_id>"
         return cib_factory.rename(old_id,new_id)
     def erase(self,cmd):
         "usage: erase"
         return cib_factory.erase()
     def refresh(self,cmd):
         "usage: refresh"
         if interactive and cib_factory.has_cib_changed():
             if not ask("All changes will be dropped. Do you want to proceed?"):
                 return
         cib_factory.refresh()
     def ptest(self,cmd):
         "usage: ptest"
         set_obj = self._mkset_obj("xml")
         set_obj.ptest()
     def commit(self,cmd,force = None):
         "usage: commit [force]"
         if not force:
             return cib_factory.commit()
         elif force == "force":
             return cib_factory.commit(True)
         else:
             syntax_err((cmd,force))
             return False
     def upgrade(self,cmd,force = None):
         "usage: upgrade [force]"
         if not force:
             return cib_factory.upgrade_cib()
         elif force == "force":
             return cib_factory.upgrade_cib(True)
         else:
             syntax_err((cmd,force))
             return False
     def enter(self,cmd,obj_type,obj_id):
         "usage: enter obj_type id"
         not_impl_info("enter")
         return
     def __conf_object(self,cmd,*args):
         "The configure object command."
         f = lambda: cib_factory.create_object(cmd,*args)
         return f()
     def conf_primitive(self,cmd,*args):
         """usage: primitive <rsc> [<class>:[<provider>:]]<type>
         [params <param>=<value> [<param>=<value>...]]
         [meta <attribute>=<value> [<attribute>=<value>...]]
         [operations id_spec
             [op op_type [<attribute>=<value>...] ...]]"""
         self.__conf_object(cmd,*args)
     def conf_group(self,cmd,*args):
         """usage: group <name> <rsc> [<rsc>...]
         [params <param>=<value> [<param>=<value>...]]
         [meta <attribute>=<value> [<attribute>=<value>...]]"""
         self.__conf_object(cmd,*args)
     def conf_clone(self,cmd,*args):
         """usage: clone <name> <rsc>
         [params <param>=<value> [<param>=<value>...]]
         [meta <attribute>=<value> [<attribute>=<value>...]]"""
         self.__conf_object(cmd,*args)
     def conf_ms(self,cmd,*args):
         """usage: ms <name> <rsc>
         [params <param>=<value> [<param>=<value>...]]
         [meta <attribute>=<value> [<attribute>=<value>...]]"""
         self.__conf_object(cmd,*args)
     def conf_location(self,cmd,*args):
         """usage: location <id> <rsc> {node_pref|rules}
 
         node_pref :: <score>: <node>
 
         rules ::
           rule [id_spec] [$role=<role>] <score>: <expression>
           [rule [id_spec] [$role=<role>] <score>: <expression> ...]
 
         id_spec :: $id=<id> | $id-ref=<id>"""
         self.__conf_object(cmd,*args)
     def conf_colocation(self,cmd,*args):
         """usage: colocation <id> <score>: <rsc>[:<role>] <rsc>[:<role>]
         """
         self.__conf_object(cmd,*args)
     def conf_order(self,cmd,*args):
         """usage: order <id> score-type: <first-rsc>[:<action>] <then-rsc>[:<action>]
         [symmetrical=<bool>]"""
         self.__conf_object(cmd,*args)
     def conf_property(self,cmd,*args):
         "usage: property [$id=<set_id>] <option>=<value>"
         self.__conf_object(cmd,*args)
     def end_game(self, no_questions_asked = False):
         if cib_factory.has_cib_changed():
             if no_questions_asked or not interactive or \
                 ask("There are changes pending. Do you want to commit them?"):
                 cib_factory.commit()
         cib_factory.reset()
         wcache.clear()
     def end(self,cmd):
         "usage: end"
         self.end_game()
         cmd_end(cmd)
     def help(self,cmd,topic = ''):
         "usage: help [<topic>]"
         cmd_help(self.help_table,topic)
     def exit(self,cmd):
         "usage: exit"
         self.end_game()
         cmd_exit(cmd)
 
 def is_element(xmlnode):
     return xmlnode.nodeType == xmlnode.ELEMENT_NODE
 
 def nameandid(xmlnode,level):
     if xmlnode.nodeType == xmlnode.ELEMENT_NODE:
         print level*' ',xmlnode.tagName,xmlnode.getAttribute("id"),xmlnode.getAttribute("name")
 
 def xmltraverse(xmlnode,fun,ts=0):
     for c in xmlnode.childNodes:
         if is_element(c):
             fun(c,ts)
             xmltraverse(c,fun,ts+1)
 
 def xmltraverse_thin(xmlnode,fun,ts=0):
     '''
     Skip elements which may be resources themselves.
     NB: Call this only on resource (or constraint) nodes, but
     never on cib or configuration!
     '''
     for c in xmlnode.childNodes:
         if is_element(c) and not c.tagName in ('primitive','group'):
             xmltraverse_thin(c,fun,ts+1)
     fun(xmlnode,ts)
 
 def xml_processnodes(xmlnode,node_filter,proc):
     '''
     Process with proc all nodes that match filter.
     '''
     node_list = []
     for child in xmlnode.childNodes:
         if node_filter(child):
             node_list.append(child)
         if child.hasChildNodes():
             xml_processnodes(child,node_filter,proc)
     if node_list:
         proc(node_list)
 
 # filter the cib
 def is_whitespace(node):
     return node.nodeType == node.TEXT_NODE and not node.data.strip()
 def is_status_node(node):
     return is_element(node) and node.tagName == "status"
 
 container_tags = ("group", "clone", "ms", "master")
 resource_tags = ("primitive","group","clone","ms","master")
 constraint_tags = ("rsc_location","rsc_colocation","rsc_order")
 constraint_rsc_refs = ("rsc","with-rsc","first","then")
 children_tags = ("group", "primitive")
 nvpairs_tags = ("meta_attributes", "instance_attributes")
 def is_emptynvpairs(node):
     return is_element(node) \
         and node.tagName in nvpairs_tags \
         and not node.hasChildNodes()
 def is_container(node):
     return is_element(node) \
         and node.tagName in container_tags
 def is_resource(node):
     return is_element(node) \
         and node.tagName in resource_tags
 def is_constraint(node):
     return is_element(node) \
         and node.tagName in constraint_tags
 def rsc_constraint(rsc_id,cons_node):
     if not is_element(cons_node):
         return False
     for attr in cons_node.attributes.keys():
         if attr in constraint_rsc_refs \
                 and rsc_id == cons_node.getAttribute(attr):
             return True
     return False
 
 resource_cli_names = ("primitive","group","clone","ms")
 constraint_cli_names = ("location","colocation","order")
 def is_resource_cli(s):
     return s in resource_cli_names
 def is_constraint_cli(s):
     return s in constraint_cli_names
 
 def sort_container_children(node_list):
     '''
     Make sure that attributes's nodes are first, followed by the
     elements (primitive/group). The order of elements is not
     disturbed, they are just shifted to end!
     '''
     for node in node_list:
         children = []
         for c in node.childNodes:
             if is_element(c) and c.tagName in children_tags:
                 children.append(c)
         for c in children:
             node.removeChild(c)
         for c in children:
             node.appendChild(c)
 def rmnodes(node_list):
     for node in node_list:
         node.parentNode.removeChild(node)
         node.unlink()
 def printid(node_list):
     for node in node_list:
         id = node.getAttribute("id")
         if id: print "node id:",id
 def sanitize_cib(doc):
     xml_processnodes(doc,is_status_node,rmnodes)
     #xml_processnodes(doc,is_element,printid)
     xml_processnodes(doc,is_emptynvpairs,rmnodes)
     xml_processnodes(doc,is_whitespace,rmnodes)
     xml_processnodes(doc,is_container,sort_container_children)
 
 def rename_id(node,old_id,new_id):
     if node.getAttribute("id") == old_id:
         node.setAttribute("id", new_id)
 def rename_rscref(c_node,old_id,new_id):
     for attr in c_node.attributes.keys():
         if attr in constraint_rsc_refs and \
                 c_node.getAttribute(attr) == old_id:
             c_node.setAttribute(attr, new_id)
 
 class IdMgmt(object):
     '''
     Make sure that ids are unique.
     '''
     def __init__(self):
         self._id_store = {}
         self.ok = True # error var
     def new(self,node,pfx):
         '''
         Create a unique id for the xml node.
         '''
         name = node.getAttribute("name")
         if node.tagName == "nvpair":
             node_id = "%s-%s" % (pfx,name)
         elif node.tagName == "op":
             interval = node.getAttribute("interval")
             if interval:
                 node_id = "%s-%s-%s" % (pfx,name,interval)
             else:
                 node_id = "%s-%s" % (pfx,name)
         else:
             try:
                 hint = hints_list[node.tagName]
             except: pass
             if hint:
                 node_id = "%s-%s" % (pfx,hint)
             else:
                 node_id = "%s" % pfx
         if self.is_used(node_id):
             for cnt in range(99): # shouldn't really get here
                 try_id = "%s-%d" % (node_id,cnt)
                 if not self.is_used(try_id):
                     node_id = try_id
                     break
         self.save(node_id)
         return node_id
     def check_node(self,node,lvl):
         node_id = node.getAttribute("id")
         if not node_id:
             return
         if id_in_use(node_id):
             self.ok = False
             return
     def _store_node(self,node,lvl):
         self.save(node.getAttribute("id"))
     def _drop_node(self,node,lvl):
         self.remove(node.getAttribute("id"))
     def check_xml(self,node):
         self.ok = True
         xmltraverse_thin(node,self.check_node)
         return self.ok
     def store_xml(self,node):
         if not self.check_xml(node):
             return False
         xmltraverse_thin(node,self._store_node)
         return True
     def remove_xml(self,node):
         xmltraverse_thin(node,self._drop_node)
     def replace_xml(self,oldnode,newnode):
         self.remove_xml(oldnode)
         if not self.store_xml(newnode):
             self.store_xml(oldnode)
             return False
         return True
     def is_used(self,node_id):
         return node_id in self._id_store
     def save(self,node_id):
         if not node_id: return
         self._id_store[node_id] = 1
     def rename(self,old_id,new_id):
         if not old_id or not new_id: return
         if not self.is_used(old_id): return
         if self.is_used(new_id): return
         self.remove(old_id)
         self.save(new_id)
     def remove(self,node_id):
         if not node_id: return
         try:
             del self._id_store[node_id]
         except KeyError:
             pass
     def clear(self):
         self._id_store = {}
 
 def id_in_use(obj_id):
     if id_store.is_used(obj_id):
         id_used_err(obj_id)
         return True
     return False
 
 #
 # CLI parsing utilities
 # WARNING: ugly code ahead (to be replaced some day by a proper
 # yacc parser, if there's such a thing)
 #
 def cli_parse_rsctype(s, pl):
     ra_class = "ocf"
     provider = "heartbeat"
     l = s.split(':')
     if len(l) == 3:
         ra_class,provider,rsc_type = l
     elif len(l) == 2:
         ra_class,rsc_type = l
     elif len(l) == 1:
         rsc_type = l[0]
     else:
         return None
     pl.append(["class",ra_class])
     if ra_class == "ocf":
         pl.append(["provider",provider])
     pl.append(["type",rsc_type])
 def cli_parse_attr(s,pl):
     if s and '=' in s[0]:
         n,v = s[0].split('=',1)
         pl.append([n,v])
         cli_parse_attr(s[1:],pl)
 def parse_resource(s):
     el_type = s[0]
     attr_lists_keyw = ["params","meta"]
     cli_list = []
     # the head
     head = []
     head.append(["id",s[1]])
     i = 3
     if el_type == "primitive":
         cli_parse_rsctype(s[2],head)
         if not find_value(head,"type"):
             syntax_err(s[2:], context = 'primitive')
             return False
     else:
         cl = []
         cl.append(s[2])
         if el_type == "group":
             while i < len(s):
                 if s[i] in attr_lists_keyw:
                     break
                 else:
                     cl.append(s[i])
                     i += 1 # skip to the next token
         head.append(["$children",cl])
     cli_list.append([el_type,head])
     # the rest
     state = 0 # 1: reading operations; 2: operations read
     while len(s) > i+1:
         pl = []
         keyw = s[i]
         if keyw in attr_lists_keyw:
             if state == 1:
                 state = 2
         elif el_type == "primitive" and state == 0 and keyw == "operations":
             state = 1
         elif el_type == "primitive" and state <= 1 and keyw == "op":
             if state == 0:
                 state = 1
             pl.append(["name",s[i+1]])
         else:
             syntax_err(s[i:], context = 'primitive')
             return False
         if keyw == "op":
             if len(s) > i+2:
                 cli_parse_attr(s[i+2:],pl)
         else:
             cli_parse_attr(s[i+1:],pl)
             if len(pl) == 0:
                 syntax_err(s[i:], context = 'primitive')
                 return False
         i += len(pl)+1
         # interval is obligary for ops, supply 0 if not there
         if keyw == "op" and not find_value(pl,"interval"):
             pl.append(["interval","0"])
         cli_list.append([keyw,pl])
     if len(s) > i:
         syntax_err(s[i:], context = 'primitive')
         return False
     return cli_list
 
 score_type = {'advisory': '0','mandatory': 'INFINITY'}
 def cli_parse_score(score,pl):
     if score.endswith(':'):
         score = score.rstrip(':')
     else:
         syntax_err(score, context = 'score')
         return False
     if score in score_type:
         pl.append(["score",score_type[score]])
     elif re.match("^[+-]?(inf|infinity|INFINITY|[[0-9]+)$",score):
         score = score.replace("infinity","INFINITY")
         score = score.replace("inf","INFINITY")
         pl.append(["score",score])
     else:
         pl.append(["score-attribute",score])
     return True
 binary_ops = ('lt','gt','lte','gte','eq','ne')
 binary_types = ('string' , 'version' , 'number')
 unary_ops = ('defined','not_defined')
 def is_binary_op(s):
     l = s.split(':')
     if len(l) == 2:
         return l[0] in binary_types and l[1] in binary_ops
     elif len(l) == 1:
         return l[0] in binary_ops
     else:
         return False
 def set_binary_op(s,pl):
     l = s.split(':')
     if len(l) == 2:
         pl.append(["type",l[0]])
         pl.append(["operation",l[1]])
     else:
         pl.append(["operation",l[0]])
 def cli_get_expression(s,pl):
     if len(s) > 1 and s[0] in unary_ops:
         pl.append(["operation",s[0]])
         pl.append(["attribute",s[1]])
     elif len(s) > 2 and is_binary_op(s[1]):
         pl.append(["attribute",s[0]])
         set_binary_op(s[1],pl)
         pl.append(["value",s[2]])
     else:
         return False
     return True
 def parse_rule(s):
     if s[0] != "rule":
         syntax_err(s,context = "rule")
         return 0,None
     rule_list = []
     head_pl = []
     rule_list.append([s[0],head_pl])
     i = 1
     cli_parse_attr(s[i:],head_pl)
     i += len(head_pl)
     if find_value(head_pl,"$id-ref"):
         return i,rule_list
     if not cli_parse_score(s[i],head_pl):
         return i,None
     i += 1
     bool_op = ''
     while len(s) > i+1:
         pl = []
         if not cli_get_expression(s[i:],pl):
             syntax_err(s[i:],context = "rule")
             return i,None
         rule_list.append(["expression",pl])
         i += len(pl)
         if len(s) > i and s[i] in ('or','and'):
             if bool_op and bool_op != s[i]:
                 common_err("rule contains different bool operations: %s" % ' '.join(s))
                 return i,None
             else:
                 bool_op = s[i]
                 i += 1
         if len(s) > i and s[i] == "rule":
             break
     if bool_op:
         head_pl.append(["boolean-op",bool_op])
     return i,rule_list
 def parse_location(s):
     cli_list = []
     head_pl = []
     head_pl.append(["id",s[1]])
     head_pl.append(["rsc",s[2]])
     cli_list.append([s[0],head_pl])
     if len(s) == 5: # the short node preference form
         if not cli_parse_score(s[3],head_pl):
             return False
         head_pl.append(["node",s[4]])
         return cli_list
     i = 3
     while i < len(s):
         numtoks,l = parse_rule(s[i:])
         if not l:
             return False
         cli_list += l
         i += numtoks
     if len(s) < i:
         syntax_err(s[i:],context = "location")
         return False
     return cli_list
 
 def cli_opt_symmetrical(s,pl):
     if not s:
         return True
     pl1 = []
     cli_parse_attr(s,pl1)
     if len(pl1) != 1 or not find_value(pl1,"symmetrical"):
         syntax_err(s,context = "order")
         return False
     pl += pl1
     return True
 roles = ('Stopped', 'Started', 'Master', 'Slave')
 def cli_parse_rsc_role(s,pl,attr_pfx = ''):
     l = s.split(':')
     pl.append([attr_pfx+"rsc",l[0]])
     if len(l) == 2:
         if l[1] not in roles:
             bad_def_err("resource role",s)
             return False
         pl.append([attr_pfx+"rsc-role",l[1]])
     elif len(l) > 2:
         bad_def_err("resource role",s)
         return False
     return True
 
 def parse_colocation(s):
     cli_list = []
     head_pl = []
     cli_list.append([s[0],head_pl])
     if len(s) != 5:
         syntax_err(s,context = "colocation")
         return False
     head_pl.append(["id",s[1]])
     if not cli_parse_score(s[2],head_pl):
         return False
     if not cli_parse_rsc_role(s[3],head_pl):
         return False
     if not cli_parse_rsc_role(s[4],head_pl,'with-'):
         return False
     return cli_list
 actions = ( 'start', 'promote', 'demote', 'stop')
 def cli_parse_rsc_action(s,pl,rsc_pos):
     l = s.split(':')
     pl.append([rsc_pos,l[0]])
     if len(l) == 2:
         if l[1] not in actions:
             bad_def_err("resource action",s)
             return False
         pl.append([rsc_pos+"-action",l[1]])
     elif len(l) > 1:
         bad_def_err("resource action",s)
         return False
     return True
 
 def parse_order(s):
     cli_list = []
     head_pl = []
     cli_list.append([s[0],head_pl])
     if len(s) < 5 or len(s) > 6:
         syntax_err(s,context = "order")
         return False
     head_pl.append(["id",s[1]])
     if not cli_parse_score(s[2],head_pl):
         return False
     if not cli_parse_rsc_action(s[3],head_pl,'first'):
         return False
     if not cli_parse_rsc_action(s[4],head_pl,'then'):
         return False
     if not cli_opt_symmetrical(s[5:],head_pl):
         return False
     return cli_list
 
 def parse_constraint(s):
     if s[0] == "location":
         return parse_location(s)
     elif s[0] == "colocation":
         return parse_colocation(s)
     elif s[0] == "order":
         return parse_order(s)
 def parse_property(s):
     cli_list = []
     head_pl = []
     cli_list.append([s[0],head_pl])
     cli_parse_attr(s[1:],head_pl)
     if len(head_pl) < 0 or len(s) > len(head_pl)+1:
         syntax_err(s, context = "property")
         return False
     return cli_list
 
 def parse_cli(s):
     '''
     Input: a list of tokens (or a CLI format string).
     Return: a list of items; each item is a tuple
         with two members: a string (tag) and a nvpairs or
         attributes dict.
     '''
     if type(s) == type(u''):
         s = s.encode('ascii')
     if type(s) == type(''):
         try: s = shlex.split(s)
         except ValueError, msg:
             common_err(msg)
             return False
     while '\n' in s:
         s.remove('\n')
     if s and s[0].startswith('#'):
         return None
     if len(s) > 1 and s[0] == "property":
         return parse_property(s)
     if len(s) < 3: # we want at least two tokens
         syntax_err(s)
         return False
     if is_resource_cli(s[0]):
         return parse_resource(s)
     elif is_constraint_cli(s[0]):
         return parse_constraint(s)
     else:
         syntax_err(s)
         return False
 
 #
 # XML generate utilities
 #
 hints_list = {
     "instance_attributes": "instance_attributes",
     "meta_attributes": "meta_attributes",
     "operations": "ops",
     "rule": "rule",
     "expression": "expression",
 }
 match_list = {
     "crm_config": (),
     "cluster_property_set": (),
     "instance_attributes": (),
     "meta_attributes": (),
     "operations": (),
     "nvpair": ("name",),
     "op": ("name","interval"),
     "rule": ("score","score-attribute","role"),
     "expression": ("attribute","operation","value"),
 }
 def set_id_used_attr(node):
     node.setAttribute("__id_used", "Yes")
 def is_id_used_attr(node):
     return node.getAttribute("__id_used") == "Yes"
 def remove_id_used_attr(node,lvl):
     if is_element(node) and is_id_used_attr(node):
         node.removeAttribute("__id_used")
 def remove_id_used_attributes(node):
     if node:
         xmltraverse(node, remove_id_used_attr)
 def lookup_node(node,oldnode,location_only = False):
     '''
     Find a child of oldnode which matches node.
     '''
     #print "match:",node.tagName,oldnode.getAttribute("id")
     if not oldnode:
         return None
     try:
         attr_list = match_list[node.tagName]
     except KeyError:
         attr_list = []
     for c in oldnode.childNodes:
         if not is_element(c):
             continue
         if not location_only and is_id_used_attr(c):
             continue
         if node.tagName == c.tagName:
             failed = False
             for a in attr_list:
                 if node.getAttribute(a) != c.getAttribute(a):
                     failed = True
                     break
             if not failed:
                 return c
     return None
 
 def set_id(node,oldnode,id_hint,id_required = True):
     '''
     Set the id attribute for the node.
     Procedure:
     - if the node already contains "id", keep it
     - if the old node contains "id", copy that
     - if neither is true, then create a new one using id_hint
       (exception: if not id_required, then no new id is generated)
     Finally, save the new id in id_store.
     '''
     old_id = None
     new_id = node.getAttribute("id")
     if oldnode and oldnode.getAttribute("id"):
         old_id = oldnode.getAttribute("id")
     if not new_id:
         new_id = old_id
     if not new_id:
         if id_required:
             new_id = id_store.new(node,id_hint)
     else:
         id_store.save(new_id)
     if new_id:
         node.setAttribute("id",new_id)
         if oldnode and old_id == new_id:
             set_id_used_attr(oldnode)
 
 def mkxmlsimple(e,oldnode,id_hint):
     '''
     Create an xml node from the (name,dict) pair. The name is the
     name of the element. The dict contains a set of attributes.
     '''
     node = cib_factory.createElement(e[0])
     for n,v in e[1]:
         if n == "$children": # this one's skipped
             continue
         if n.startswith('$'):
             n = n.lstrip('$')
         if (type(v) != type('') and type(v) != type(u'')) \
                 or v: # skip empty strings
             node.setAttribute(n,v)
     set_id(node,lookup_node(node,oldnode),id_hint)
     return node
 
 def find_value(pl,name):
     for n,v in pl:
         if n == name:
             return v
     return None
 def mkxmlnvpairs(e,oldnode,id_hint):
     '''
     Create xml from the (name,dict) pair. The name is the name of
     the element. The dict contains a set of nvpairs. Stuff such
     as instance_attributes.
     NB: Other tags not containing nvpairs are fine if the dict is empty.
     '''
     node = cib_factory.createElement(e[0])
     match_node = lookup_node(node,oldnode)
     v = find_value(e[1],"$id")
     if v:
         node.setAttribute("id",v)
         e[1].remove(["$id",v])
     else:
         if e[0] == "operations": # operations don't need no id
             set_id(node,match_node,id_hint,id_required = False)
         else:
             set_id(node,match_node,id_hint)
     v = find_value(e[1],"$id-ref")
     if v:
         node.setAttribute("id-ref",v)
         e[1].remove(["$id-ref",v])
     try:
         hint = hints_list[e[0]]
     except: hint = ''
     hint = hint and "%s_%s" % (id_hint,hint) or id_hint
     nvpair_pfx = node.getAttribute("id") or hint
     for n,v in e[1]:
         nvpair = cib_factory.createElement("nvpair")
         node.appendChild(nvpair)
         nvpair.setAttribute("name",n)
         nvpair.setAttribute("value",v)
         set_id(nvpair,lookup_node(nvpair,match_node),nvpair_pfx)
     return node
 
 def mkxmlop(e,oldnode,id_hint):
     '''
     Create an operation xml from the (name,dict) pair.
     '''
     node = cib_factory.createElement(e[0])
     for n,v in e[1]:
         node.setAttribute(n,v)
     tmp = cib_factory.createElement("operations")
     oldops = lookup_node(tmp,oldnode) # first find old operations
     set_id(node,lookup_node(node,oldops),id_hint)
     return node
 
 conv_list = {
     "params": "instance_attributes",
     "meta": "meta_attributes",
     "property": "cluster_property_set"
 }
 def mkxmlnode(e,oldnode,id_hint):
     '''
     Create xml from the (name,dict) pair. The name is the name of
     the element. The dict contains either a set of nvpairs or a
     set of attributes. The id is either generated or copied if
     found in the provided xml. Stuff such as instance_attributes.
     '''
     if e[0] in conv_list:
         e[0] = conv_list[e[0]]
     if e[0] in ("instance_attributes","meta_attributes","operations","cluster_property_set"):
         return mkxmlnvpairs(e,oldnode,id_hint)
     elif e[0] == "op":
         return mkxmlop(e,oldnode,id_hint)
     else:
         return mkxmlsimple(e,oldnode,id_hint)
 
 def new_cib():
     doc = xml.dom.minidom.Document()
     cib = doc.createElement("cib")
     doc.appendChild(cib)
     configuration = doc.createElement("configuration")
     cib.appendChild(configuration)
     crm_config = doc.createElement("crm_config")
     configuration.appendChild(crm_config)
     nodes = doc.createElement("nodes")
     configuration.appendChild(nodes)
     resources = doc.createElement("resources")
     configuration.appendChild(resources)
     constraints = doc.createElement("constraints")
     configuration.appendChild(constraints)
     return doc,cib,crm_config,nodes,resources,constraints
 def get_cib_elem(doc, tag):
     try:
         e = doc.getElementsByTagName(tag)[0]
     except:
         cib_no_elem_err(tag)
         return None
     return e
 def read_cib(cmd):
     doc = xml2doc(cmd)
     if not doc:
         return doc,None,None,None,None,None,None
     cib = doc.childNodes[0]
     if not is_element(cib) or cib.tagName != "cib":
         cib_no_elem_err("cib")
         return doc,None,None,None,None,None,None
     crm_config = get_cib_elem(cib, "crm_config")
     nodes = get_cib_elem(cib, "nodes")
     resources = get_cib_elem(cib, "resources")
     constraints = get_cib_elem(cib, "constraints")
     status = get_cib_elem(cib, "status")
     return doc,cib,crm_config,nodes,resources,constraints,status
 
 def set_property(set_node,name,value):
     n_id = set_node.getAttribute("id")
     for c in set_node.childNodes:
         if is_element(c) and c.getAttribute("name") == name:
             c.setAttribute("value",value)
             return
     np = cib_factory.createElement("nvpair")
     np.setAttribute("name",name)
     np.setAttribute("value",value)
     new_id = id_store.new(np,n_id)
     np.setAttribute("id",new_id)
     set_node.appendChild(np)
 
 def xml_cmp(n,m):
     #if hash(n.toxml()) != hash(m.toxml()):
     #   print n.toprettyxml(); print m.toprettyxml()
     return hash(n.toxml()) == hash(m.toxml())
 
 def get_interesting_nodes(node,nodes):
     for c in node.childNodes:
         if is_element(c) and c.tagName in cib_object_map:
             nodes.append(c)
         get_interesting_nodes(c,nodes)
     return nodes
 
 def filter_on_tag(nl,tag):
     return [node for node in nl if node.tagName == tag]
 def primitives(node_list):
     return filter_on_tag(node_list,"primitive")
 def groups(node_list):
     return filter_on_tag(node_list,"group")
 def clones(node_list):
     return filter_on_tag(node_list,"clone")
 def mss(node_list):
     return filter_on_tag(node_list,"master")
 def constraints(node_list):
     return filter_on_tag(node_list,"rsc_location") \
         + filter_on_tag(node_list,"rsc_colocation") \
         + filter_on_tag(node_list,"rsc_order")
 def properties(node_list):
     return filter_on_tag(node_list,"cluster_property_set")
 def processing_sort(nl):
     '''
     It's usually important to process cib objects in this order,
     i.e. simple objects first.
     '''
     return primitives(nl) + groups(nl) + mss(nl) + clones(nl) \
         + constraints(nl) + properties(nl)
 
 def filter_on_type(cl,obj_type):
     if type(cl[0]) == type([]):
         return [cli_list for cli_list in cl if cli_list[0][0] == obj_type]
     else:
         return [obj for obj in cl if obj.obj_type == obj_type]
 def primitives_cli(cl):
     return filter_on_type(cl,"primitive")
 def groups_cli(cl):
     return filter_on_type(cl,"group")
 def clones_cli(cl):
     return filter_on_type(cl,"clone")
 def mss_cli(cl):
     return filter_on_type(cl,"ms")
 def constraints_cli(node_list):
     return filter_on_type(node_list,"location") \
         + filter_on_type(node_list,"colocation") \
         + filter_on_type(node_list,"order")
 def properties_cli(cl):
     return filter_on_type(cl,"property")
 def processing_sort_cli(cl):
     return primitives_cli(cl) + groups_cli(cl) + mss_cli(cl) + clones_cli(cl) \
         + constraints_cli(cl) + properties_cli(cl)
 
 def referenced_resources_cli(cli_list):
     id_list = []
     head = cli_list[0]
     obj_type = head[0]
     if obj_type == "location":
         id_list.append(find_value(head[1],"rsc"))
     elif obj_type == "colocation":
         id_list.append(find_value(head[1],"rsc"))
         id_list.append(find_value(head[1],"with-rsc"))
     elif obj_type == "order":
         id_list.append(find_value(head[1],"first"))
         id_list.append(find_value(head[1],"then"))
     return id_list
 
 #
 # CLI format generation utilities (from XML)
 #
 def cli_format(pl,format):
     if format:
         return ' \\\n\t'.join(pl)
     else:
         return ' '.join(pl)
 def cli_pairs(pl):
     'Return a string of name="value" pairs (passed in a list of pairs).'
     l = []
     for n,v in pl:
         l.append('%s="%s"'%(n,v))
     return ' '.join(l)
 def nvpairs2list(node):
     "Convert nvpairs to a list of pairs."
     pl = []
     for c in node.childNodes:
         if not is_element(c):
             continue
         if c.tagName == "attributes":
             pl = nvpairs2list(c)
         name = c.getAttribute("name")
         value = c.getAttribute("value")
         pl.append([name,value])
     return pl
 def op2cli(node):
     pl = []
     for name in node.attributes.keys():
         if name == "name":
             action = node.getAttribute(name)
         elif name != "id": # skip the id
             pl.append([name,node.getAttribute(name)])
     return "op %s %s"%(action,cli_pairs(pl))
 def cli_operations(node,format = True):
     l = []
     node_id = node.getAttribute("id")
     if node_id:
         l.append('operations $id="%s"' % node_id)
     else:
         idref = node.getAttribute("id-ref")
         if idref:
             l.append('operations $id-ref="%s"' % idref)
     for c in node.childNodes:
         if is_element(c) and c.tagName == "op":
             l.append(op2cli(c))
     return cli_format(l,format)
 def exp2cli(node):
     operation = node.getAttribute("operation")
     attribute = node.getAttribute("attribute")
     value = node.getAttribute("value")
     if not value:
         return "%s %s" % (operation,attribute)
     else:
         return "%s %s %s" % (attribute,operation,value)
 def get_score(node):
     score = node.getAttribute("score")
     if not score:
         score = node.getAttribute("score-attribute")
     else:
         if score.find("INFINITY") >= 0:
             score = score.replace("INFINITY","inf")
     return score + ":"
 def cli_rule(node):
     s = []
     node_id = node.getAttribute("id")
     if node_id:
         s.append('$id="%s"' % node_id)
     else:
         idref = node.getAttribute("id-ref")
         if idref:
             return '$id-ref="%s"' % idref
     rsc_role = node.getAttribute("role")
     if rsc_role:
         s.append('$role="%s"' % rsc_role)
     s.append(get_score(node))
     bool_op = node.getAttribute("boolean-op")
     if not bool_op:
         bool_op = "and"
     exp = []
     for c in node.childNodes:
         if is_element(c) and c.tagName == "expression":
             exp.append(exp2cli(c))
     expression = (" %s "%bool_op).join(exp)
     return "%s %s" % (' '.join(s),expression)
 def primitive_head(node):
     obj_type = cib_object_map[node.tagName][0]
     node_id = node.getAttribute("id")
     ra_type = node.getAttribute("type")
     ra_class = node.getAttribute("class")
     ra_provider = node.getAttribute("provider")
     s1 = s2 = ''
     if ra_class:
         s1 = "%s:"%ra_class
     if ra_provider:
         s2 = "%s:"%ra_provider
     return "%s %s %s"%(obj_type,node_id,''.join((s1,s2,ra_type)))
 def cont_head(node):
     obj_type = cib_object_map[node.tagName][0]
     node_id = node.getAttribute("id")
     children = []
     for c in node.childNodes:
         if not is_element(c):
             continue
         if (obj_type == "group" and c.tagName == "primitive") or \
                 c.tagName in ("primitive","group"):
             children.append(c.getAttribute("id"))
         elif obj_type in ("clone","ms") and \
                 c.tagName in ("primitive","group"):
             children.append(c.getAttribute("id"))
     return "%s %s %s"%(obj_type,node_id,' '.join(children))
 def location_head(node):
     obj_type = cib_object_map[node.tagName][0]
     node_id = node.getAttribute("id")
     rsc = node.getAttribute("rsc")
     s = "%s %s %s"%(obj_type,node_id,rsc)
     pref_node = node.getAttribute("node")
     if pref_node:
         return "%s %s %s" % (s,get_score(node),pref_node)
     else:
         return s
 def mkrscrole(node,n):
     rsc = node.getAttribute(n)
     rsc_role = node.getAttribute(n + "-role")
     if rsc_role:
         return "%s:%s"%(rsc,rsc_role)
     else:
         return rsc
 def mkrscaction(node,n):
     rsc = node.getAttribute(n)
     rsc_action = node.getAttribute(n + "-action")
     if rsc_action:
         return "%s:%s"%(rsc,rsc_action)
     else:
         return rsc
 def simple_constraint_head(node):
     obj_type = cib_object_map[node.tagName][0]
     node_id = node.getAttribute("id")
     score = get_score(node)
     col = []
     if obj_type == "colocation":
         col.append(mkrscrole(node,"rsc"))
         col.append(mkrscrole(node,"with-rsc"))
     else:
         col.append(mkrscaction(node,"first"))
         col.append(mkrscaction(node,"then"))
     symm = node.getAttribute("symmetrical")
     if symm:
         col.append("symmetrical=%s"%symm)
     return "%s %s %s %s"%(obj_type,node_id,score,' '.join(col))
 
 class CibObjectSet(object):
     '''
     Edit or display a set of cib objects.
     repr() for objects representation and
     save() used to store objects into internal structures
     are defined in subclasses.
     '''
     def __init__(self, *args):
         self.obj_list = []
     def _open_url(self,src):
         import urllib
         try:
             return urllib.urlopen(src)
         except:
             pass
         if src == "-":
             return sys.stdin
         try:
             return open(src)
         except:
             pass
         common_err("could not open %s" % src)
         return False
     def edit_save(self,s,erase = False):
         '''
         Save string s to a tmp file. Invoke editor to edit it.
         Parse/save the resulting file. In case of syntax error,
         allow user to reedit. If erase is True, erase the CIB
         first.
         If no changes are done, return silently.
         '''
         tmp = str2tmp(s)
         if not tmp:
             return
         filehash = hash(s)
         while True:
             if edit_file(tmp) != 0:
                 break
             try: f = open(tmp,'r')
             except IOError, msg:
                 common_err(msg)
                 break
             s = ''.join(f)
             f.close()
             if hash(s) == filehash: # file unchanged
                 break
             if erase:
                 cib_factory.erase()
             if not self.save(s):
                 if ask("There was a parsing problem. Do you want to edit again?"):
                     continue
             break
         try: os.unlink(tmp)
         except: pass
     def edit(self):
         if batch:
             common_info("edit not allowed in batch mode")
             return
         err_buf.buffer() # keep error messages
         s = self.repr()
         err_buf.release() # show them, but get an ack from the user
         return self.edit_save(s)
     def import_template(self,template):
         f = self._open_url(template)
         if not f:
             return
         s = ''.join(f)
         if f != sys.stdin:
             f.close()
         return self.edit_save(s,erase = True)
     def save_to_file(self,fname):
         if fname == "-":
             f = sys.stdout
         else:
             if not batch and os.access(fname,os.F_OK):
                 if not ask("File %s exists. Do you want to overwrite it?"%fname):
                     return
             try: f = open(fname,"w")
             except IOError, msg:
                 common_err(msg)
                 return
         f.write(self.repr())
         f.write('\n')
         if f != sys.stdout:
             f.close()
     def show(self):
         err_buf.buffer() # keep error messages
         s = self.repr()
         err_buf.release() # show them, but get an ack from the user
         page_string(s)
     def import_file(self,method,fname):
         if method == "replace":
             if interactive and cib_factory.has_cib_changed():
                 if not ask("This operation will erase all changes. Do you want to proceed?"):
                     return False
             cib_factory.erase()
         f = self._open_url(fname)
         if not f:
             return False
         s = ''.join(f)
         if f != sys.stdin:
             f.close()
         return self.save(s)
     def repr(self):
         '''
         Return a string with objects's representations (either
         CLI or XML).
         '''
         return ''
     def save(self,s):
         '''
         For each object:
             - try to find a corresponding object in obj_list
             - if not found: create new
             - if found: replace the object in the obj_list with
               the new object
         See below for specific implementations.
         '''
         pass
     def lookup_cli(self,cli_list):
         for obj in self.obj_list:
             if obj.matchcli(cli_list):
                 return obj
     def lookup(self,xml_obj_type,obj_id):
         for obj in self.obj_list:
             if obj.match(xml_obj_type,obj_id):
                 return obj
     def drop_remaining(self):
         'Any remaining objects in obj_list are deleted.'
         for obj in self.obj_list:
             cib_factory.delete(obj.obj_id)
 
 class CibObjectSetCli(CibObjectSet):
     '''
     Edit or display a set of cib objects (using cli notation).
     '''
     def __init__(self, *args):
         CibObjectSet.__init__(self, *args)
         self.obj_list = cib_factory.mkobj_list("cli",*args)
     def repr(self):
         "Return a string containing cli format of all objects."
         if not self.obj_list:
             return ''
         return '\n'.join(obj.repr_cli() \
             for obj in processing_sort_cli(self.obj_list))
     def process(self,cli_list):
         obj = self.lookup_cli(cli_list)
         if obj:
             if obj.update_from_cli(cli_list) != False:
                 self.obj_list.remove(obj)
             else:
                 return False
         else:
             return cib_factory.create_from_cli(cli_list)
     def save(self,s):
         '''
         Save a user supplied cli format configuration.
         On syntax error, no changes are done and user is
         typically asked to review the configuration (for instance
         on editting).
         On processing errors, there's no way back.
         TODO: Implement undo configuration changes.
         '''
         l = []
         rc = True
         for cli_text in lines2cli(s):
             cli_list = parse_cli(cli_text)
             if cli_list:
                 l.append(cli_list)
             elif cli_list == False:
                 rc = False
         # we can't proceed if there was a syntax error, but we
         # can ask the user to fix problems
         if not rc:
             return rc
         if l:
             for cli_list in processing_sort_cli(l):
                 self.process(cli_list)
         self.drop_remaining()
         return rc
 
 class CibObjectSetRaw(CibObjectSet):
     '''
     Edit or display one or more CIB objects (XML).
     '''
     def __init__(self, *args):
         CibObjectSet.__init__(self, *args)
         self.obj_list = cib_factory.mkobj_list("xml",*args)
     def repr(self):
         "Return a string containing xml of all objects."
         doc = cib_factory.objlist2doc(self.obj_list)
         s = doc.toprettyxml(user_prefs.xmlindent)
         doc.unlink()
         return s
     def process(self,node):
         obj = self.lookup(node.tagName,node.getAttribute("id"))
         if obj:
             if obj.update_from_node(node) != False:
                 self.obj_list.remove(obj)
             else:
                 return False
         else:
             return cib_factory.create_from_node(node)
     def save(self,s):
         try:
             doc = xml.dom.minidom.parseString(s)
         except xml.parsers.expat.ExpatError,msg:
             cib_parse_err(msg)
             return False
         sanitize_cib(doc)
         newnodes = get_interesting_nodes(doc,[])
         if newnodes:
             for node in processing_sort(newnodes):
                 self.process(node)
         self.drop_remaining()
         doc.unlink()
         return True
     def verify(self):
         pipe_string(cib_verify,self.repr())
     def ptest(self):
         ptest = "ptest -X -VV"
         if os.getenv("DISPLAY") and user_prefs.dotty:
             fd,tmpfile = mkstemp()
             ptest = "%s -D %s" % (ptest,tmpfile)
         else:
             tmpfile = None
         doc = cib_factory.objlist2doc(self.obj_list)
         cib = doc.childNodes[0]
         curr_cib = read_cib(cib_dump)
         if not curr_cib[0]:
             return
         status = curr_cib[6]
         st_node = doc.importNode(status,1)
         cib.appendChild(st_node)
         nodes = curr_cib[3]
         n_node = doc.importNode(nodes,1)
         conf = get_cib_elem(doc, "configuration")
         r_node = get_cib_elem(doc, "nodes")
         conf.replaceChild(n_node,r_node)
         pipe_string(ptest,doc.toprettyxml())
         doc.unlink()
         if tmpfile:
             p = subprocess.Popen("%s %s" % (user_prefs.dotty,tmpfile), shell=True, bufsize=0, stdin=None, stdout=None, stderr=None, close_fds=True)
             common_info("starting %s to show transition graph"%user_prefs.dotty)
             tmpfiles.append(tmpfile)
 
 class CibObject(object):
     '''
     The top level object of the CIB. Resources and constraints.
     '''
     def __init__(self,xml_obj_type,obj_id = None):
         self.backtrans = {}  # generate a translation cli -> tag
         for key in cib_object_map:
             self.backtrans[cib_object_map[key][0]] = key
         if xml_obj_type in cib_object_map:
             self.obj_type = cib_object_map[xml_obj_type][0]
             self.parent_type = cib_object_map[xml_obj_type][2]
             self.xml_obj_type = xml_obj_type
         else:
             unsupported_err(xml_obj_type)
             return
         self.origin = "" # where did it originally come from?
         self.nocli = False # we don't support this one
         self.updated = False # was the object updated
         self.parent = None # object superior (group/clone/ms)
         self.children = [] # objects inferior
         if obj_id:
             self.new(obj_id)
         else:
             self.obj_id = None
             self.node = None
     def repr_cli(self,node = None,format = True):
         '''
         CLI representation for the node. Defined in subclasses.
         '''
         return ''
     def cli2node(self,cli,oldnode = None):
         '''
         Convert CLI representation to a DOM node.
         Defined in subclasses.
         '''
         return None
     def save_xml(self,node):
         self.obj_id = node.getAttribute("id")
         self.node = node
         return self.cli_use_validate()
     def new(self,obj_id):
         if id_in_use(obj_id):
             return False
         tag = self.xml_obj_type
         self.node = cib_factory.createElement(tag)
         self.obj_id = obj_id
         self.node.setAttribute("id",self.obj_id)
         self.origin = "user"
     def attr_exists(self,attr):
         if not attr in self.node.attributes.keys():
             no_attribute_err(attr,self.obj_id)
             return False
         return True
     def cli_use_validate(self):
         '''
         Check validity of the object, as we know it. It may
         happen that we don't recognize a construct, but that the
         object is still valid for the CRM. In that case, the
         object is marked as "CLI read only", i.e. we will neither
         convert it to CLI nor try to edit it in that format.
 
         The validation procedure:
         we convert xml to cli and then back to xml. If the two
         xml representations match then we can understand the xml.
         '''
         if not self.node:
             return True
         if not self.attr_exists("id"):
             return False
         cli_text = self.repr_cli()
         if not cli_text:
             return False
         xml2 = self.cli2node(cli_text)
         if not xml2:
             return False
         rc = xml_cmp(self.node,xml2)
         xml2.unlink()
         return rc
     def matchcli(self,cli_list):
         head = cli_list[0]
         return self.obj_type == head[0] \
             and self.obj_id == find_value(head[1],"id")
     def match(self,xml_obj_type,obj_id):
         return self.xml_obj_type == xml_obj_type and self.obj_id == obj_id
     def obj_string(self):
         return "%s:%s" % (self.obj_type,self.obj_id)
     def propagate_updated(self):
         p = self.parent
         while p:
             p.updated = self.updated
             p = p.parent
     def update_from_cli(self,cli_list):
         'Update ourselves from the cli intermediate.'
         if not cib_factory.verify_cli(cli_list):
             return False
         oldnode = self.node
         id_store.remove_xml(oldnode)
         newnode = self.cli2node(cli_list)
         if not newnode:
             id_store.store_xml(oldnode)
             return True
         if xml_cmp(oldnode,newnode):
             newnode.unlink()
             return True # the new and the old versions are equal
         oldnode.parentNode.replaceChild(newnode,oldnode)
         self.node = newnode
         cib_factory.adjust_children(self,cli_list)
         oldnode.unlink()
         self.updated = True
         self.propagate_updated()
         return True
     def update_from_node(self,node):
         'Update ourselves from a doc node.'
         if not node:
             return False
         oldxml = self.node
         newxml = node
         if xml_cmp(oldxml,newxml):
             return True # the new and the old versions are equal
         if not id_store.replace_xml(oldxml,newxml):
             return False
         oldxml.unlink()
         self.node = cib_factory.doc.importNode(newxml,1)
         cib_factory.topnode[self.parent_type].appendChild(self.node)
         cib_factory.update_links(self)
         self.updated = True
         self.propagate_updated()
     def find_child_in_node(self,child):
         for c in self.node.childNodes:
             if not is_element(c):
                 continue
             if c.tagName == child.obj_type and \
                     c.getAttribute("id") == child.obj_id:
                 return c
         return None
 
 class CibPrimitive(CibObject):
     '''
     Primitives.
     '''
     def repr_cli(self,node = None,format = True):
         if not node:
             node = self.node
         l = []
         l.append(primitive_head(node))
         for c in node.childNodes:
             if not is_element(c):
                 continue
             if c.tagName == "instance_attributes":
                 l.append("params %s" % cli_pairs(nvpairs2list(c)))
             elif c.tagName == "meta_attributes":
                 l.append("meta %s" % cli_pairs(nvpairs2list(c)))
             elif c.tagName == "operations":
                 l.append(cli_operations(c,format))
         return cli_format(l,format)
     def cli2node(self,cli,oldnode = None):
         '''
         Convert a CLI description to DOM node.
         Try to preserve as many ids as possible in case there's
         an old XML version.
         '''
         if type(cli) == type('') or type(cli) == type(u''):
             cli_list = parse_cli(cli)
         else:
             cli_list = cli
         if not cli_list:
             return None
         if not oldnode:
             oldnode = self.node
         head = copy.copy(cli_list[0])
         head[0] = self.backtrans[head[0]]
         headnode = mkxmlsimple(head,oldnode,'rsc')
         id_hint = headnode.getAttribute("id")
         operations = None
         for e in cli_list[1:]:
             n = mkxmlnode(e,oldnode,id_hint)
             if e[0] == "operations":
                 operations = n
             if e[0] != "op":
                 headnode.appendChild(n)
             else:
                 if not operations:
                     operations = mkxmlnode(["operations",{}],oldnode,id_hint)
                     headnode.appendChild(operations)
                 operations.appendChild(n)
         remove_id_used_attributes(oldnode)
         return headnode
 
 class CibContainer(CibObject):
     '''
     Groups and clones and ms.
     '''
     def repr_cli(self,node = None,format = True):
         if not node:
             node = self.node
         l = []
         l.append(cont_head(node))
         for c in node.childNodes:
             if not is_element(c):
                 continue
             if c.tagName == "instance_attributes":
                 l.append("params %s" % cli_pairs(nvpairs2list(c)))
             elif c.tagName == "meta_attributes":
                 l.append("meta %s" % cli_pairs(nvpairs2list(c)))
         return cli_format(l,format)
     def cli2node(self,cli,oldnode = None):
         if type(cli) == type('') or type(cli) == type(u''):
             cli_list = parse_cli(cli)
         else:
             cli_list = cli
         if not cli_list:
             return None
         if not oldnode:
             oldnode = self.node
         head = copy.copy(cli_list[0])
         head[0] = self.backtrans[head[0]]
         headnode = mkxmlsimple(head,oldnode,'grp')
         id_hint = headnode.getAttribute("id")
         for e in cli_list[1:]:
             n = mkxmlnode(e,oldnode,id_hint)
             headnode.appendChild(n)
         v = find_value(head[1],"$children")
         if v:
             for child_id in v:
                 obj = cib_factory.find_object(child_id)
                 if obj:
                     n = obj.node.cloneNode(1)
                     headnode.appendChild(n)
                 else:
                     no_object_err(child_id)
         remove_id_used_attributes(oldnode)
         return headnode
 
 class CibLocation(CibObject):
     '''
     Location constraint.
     '''
     def repr_cli(self,node = None,format = True):
         if not node:
             node = self.node
         l = []
         l.append(location_head(node))
         for c in node.childNodes:
             if not is_element(c):
                 continue
             if c.tagName == "rule":
                 l.append("rule %s" % cli_rule(c))
         return cli_format(l,format)
     def cli2node(self,cli,oldnode = None):
         if type(cli) == type('') or type(cli) == type(u''):
             cli_list = parse_cli(cli)
         else:
             cli_list = cli
         if not cli_list:
             return None
         if not oldnode:
             oldnode = self.node
         head = copy.copy(cli_list[0])
         head[0] = self.backtrans[head[0]]
         headnode = mkxmlsimple(head,oldnode,'location')
         id_hint = headnode.getAttribute("id")
         oldrule = None
         for e in cli_list[1:]:
             if e[0] == "expression":
                 n = mkxmlnode(e,oldrule,id_hint)
             else:
                 n = mkxmlnode(e,oldnode,id_hint)
             if e[0] == "rule":
                 rule = n
                 headnode.appendChild(n)
                 oldrule = lookup_node(rule,oldnode,location_only=True)
             else:
                 rule.appendChild(n)
         remove_id_used_attributes(oldnode)
         return headnode
 
 class CibSimpleConstraint(CibObject):
     '''
     Colocation and order constraints.
     '''
     def repr_cli(self,node = None,format = True):
         if not node:
             node = self.node
         l = []
         l.append(simple_constraint_head(node))
         return cli_format(l,format)
     def cli2node(self,cli,oldnode = None):
         if type(cli) == type('') or type(cli) == type(u''):
             cli_list = parse_cli(cli)
         else:
             cli_list = cli
         if not cli_list:
             return None
         if not oldnode:
             oldnode = self.node
         head = copy.copy(cli_list[0])
         head[0] = self.backtrans[head[0]]
         headnode = mkxmlsimple(head,oldnode,'')
         return headnode
 
 default_cluster_property_set = "cib-bootstrap-options"
 class CibProperty(CibObject):
     '''
     Cluster properties.
     '''
     def repr_cli(self,node = None,format = True):
         if not node:
             node = self.node
         l = []
         l.append('property $id="%s"' % node.getAttribute("id"))
         properties = nvpairs2list(node)
         for n,v in properties:
             l.append('%s="%s"' % (n,v))
         return cli_format(l,format)
     def cli2node(self,cli,oldnode = None):
         if type(cli) == type('') or type(cli) == type(u''):
             cli_list = parse_cli(cli)
         else:
             cli_list = cli
         if not cli_list:
             return None
         if not oldnode:
             oldnode = cib_factory.topnode["crm_config"]
         head = copy.copy(cli_list[0])
         head[0] = self.backtrans[head[0]]
         obj_id = find_value(head[1],"$id")
         if not obj_id:
             obj_id = default_cluster_property_set
         headnode = mkxmlnode(head,oldnode,obj_id)
         remove_id_used_attributes(oldnode)
         return headnode
     def matchcli(self,cli_list):
         head = cli_list[0]
         return self.obj_type == head[0] \
             and self.obj_id == find_value(head[1],"$id")
 
 # xml -> cli translations (and classes)
 cib_object_map = {
     "primitive": ( "primitive", CibPrimitive, "resources" ),
     "group": ( "group", CibContainer, "resources" ),
     "clone": ( "clone", CibContainer, "resources" ),
     "master": ( "ms", CibContainer, "resources" ),
     "rsc_location": ( "location", CibLocation, "constraints" ),
     "rsc_colocation": ( "colocation", CibSimpleConstraint, "constraints" ),
     "rsc_order": ( "order", CibSimpleConstraint, "constraints" ),
     "cluster_property_set": ( "property", CibProperty, "crm_config" ),
 }
 
 class CibFactory(object):
     '''
     Juggle with CIB objects.
     See check_structure below for details on the internal cib
     representation.
     '''
     def __init__(self, cibfile=None):
         self.doc = None  # the cib
         self.topnode = {}
         self.topnode["resources"] = None  # the resources node
         self.topnode["constraints"] = None # the constraints node
         self.topnode["crm_config"] = None # the crm_config node
         self.cib_attrs = {} # cib version dictionary
         self.cib_objects = [] # a list of cib objects
         self.remove_queue = [] # a list of cib objects to be removed
         self.cibfile = cibfile # for testing
         self.overwrite = False # update cib unconditionally
         self.all_committed = True # has commit produced error
     def check_topnode(self,obj):
         if not obj.node.parentNode.isSameNode(self.topnode[obj.parent_type]):
             common_err("object %s is not linked to %s"%(obj.obj_id,obj.parent_type))
     def check_parent(self,obj,parent):
         if not obj in parent.children:
             common_err("object %s does not reference its child %s"%(parent.obj_id,obj.obj_id))
             return False
         if not parent.node.isSameNode(obj.node.parentNode):
             common_err("object %s node is not a child of its parent %s, but %s:%s"%(obj.obj_id,parent.obj_id,obj.node.tagName,obj.node.getAttribute("id")))
             return False
     def check_structure(self):
         #print "Checking structure..."
         rc = True
         for obj in self.cib_objects:
             #print "Checking %s... (%s)" % (obj.obj_id,obj.nocli)
             if obj.parent:
                 if self.check_parent(obj,obj.parent) == False:
                     rc = False
             else:
                 if self.check_topnode(obj) == False:
                     rc = False
             for child in obj.children:
                 if self.check_parent(child,child.parent) == False:
                     rc = False
         return rc
     def createElement(self,tag):
         if self.doc:
             return self.doc.createElement(tag)
     def check_cib_release(self,cib):
         req = cib.getAttribute("crm_feature_set")
         validator = cib.getAttribute("validate-with")
         if validator and re.match("^pacemaker-1[.]0$",validator):
             return True
         cib_ver_unsupported_err(validator,req)
         return False
     def upgrade_cib(self,force = False):
         if not self.doc:
             return False
         req = self.doc.getAttribute("crm_feature_set")
         validator = self.doc.getAttribute("validate-with")
         if force or not validator or re.match("0[.]6",validator):
             return ext_cmd(cib_upgrade)
     def parse_cib(self):
         curr_cib = read_cib(cib_dump)
         for el in curr_cib:
             if not el:
                 self.reset()
                 return False
         self.doc = curr_cib[0]
         cib = curr_cib[1]
         if not self.check_cib_release(cib):
             self.reset()
             return False
         for attr in cib.attributes.keys():
             self.cib_attrs[attr] = cib.getAttribute(attr)
         self.topnode["crm_config"] = curr_cib[2]
         self.topnode["resources"] = curr_cib[4]
         self.topnode["constraints"] = curr_cib[5]
         return True
     def chk_attribute(self,c,a):
         try: cib_attr = self.cib_attrs[a]
         except: cib_attr = None
         return c.getAttribute(a) == cib_attr
     def commit(self,force = False):
         'Commit the configuration to the CIB.'
         # 0. ensure that cib didn't change in the meantime
         if not force and not self.overwrite:
             curr_cib = read_cib(cib_dump)
             doc = curr_cib[0]
             if not doc:
                 return False
             cib = curr_cib[1]
             if not cib:
                 doc.unlink()
                 return False
             if not self.chk_attribute(cib,'epoch') or \
                     not self.chk_attribute(cib,'admin_epoch'):
                 common_warn("CIB changed in the meantime: won't touch it!")
                 common_info("use 'commit force' to force the changes.")
                 doc.unlink()
                 return False
             doc.unlink()
         self.all_committed = True
         cnt = 0
         # 1. remove objects
         cnt += self.delete_objects()
         # 2. create objects
         cnt += self.commit_objects(lambda o: o.origin == 'user','-C')
         # 3. replace objects
         cnt += self.commit_objects(lambda o: o.origin != 'user' and o.updated,'-R')
         # reload the cib!
         if force:
             self.reset()
             self.initialize()
         elif cnt:
             try:
                 epoch = self.cib_attrs['epoch']
                 self.cib_attrs['epoch'] = "%d"%(int(epoch)+cnt)
             except: pass
         return self.all_committed
     def set_cib_attributes(self,cib):
         for attr in self.cib_attrs:
             cib.setAttribute(attr,self.cib_attrs[attr])
     def objlist2doc(self,obj_list,obj_filter = None):
         '''
         Return document containing objects in obj_list.
         Must remove all children from the object list, because
         printing xml of parents will include them.
         Optional filter to sieve objects.
         '''
         doc,cib,crm_config,nodes,resources,constraints = new_cib()
         for obj in [obj for obj in obj_list if not obj.parent]:
             if obj_filter and not obj_filter(obj):
                 continue
             i_node = doc.importNode(obj.node,1)
             if obj.parent_type == "resources":
                 resources.appendChild(i_node)
             elif obj.parent_type == "constraints":
                 constraints.appendChild(i_node)
             elif obj.parent_type == "crm_config":
                 crm_config.appendChild(i_node)
         self.set_cib_attributes(cib)
         return doc
     def delete_objects(self):
         cnt = 0
         if not self.remove_queue:
             return 0
         obj_list = processing_sort_cli(self.remove_queue)
         for obj in reversed(obj_list):
             node = self.createElement(obj.xml_obj_type)
             node.setAttribute("id",obj.obj_id)
             #print node.toprettyxml()
             rc = pipe_string("%s -D"%cib_piped,node.toxml())
             if not rc:
                 self.remove_queue.remove(obj)
                 cnt += 1
             else:
                 update_err(obj.obj_id,'-D',node)
                 self.all_committed = False
             node.unlink()
         return cnt
     def commit_objects(self,obj_filter,cibadm_opt):
         upd_list = []
         for obj in self.cib_objects:
             if not obj_filter or obj_filter(obj):
                 if not obj.parent and not obj in upd_list: # only top children!
                     upd_list.append(obj)
         cnt = 0
         if not upd_list:
             return 0
         for obj in processing_sort_cli(upd_list):
             #print obj.node.toprettyxml()
             rc = pipe_string("%s %s -o %s" % \
                 (cib_piped,cibadm_opt,obj.parent_type),obj.node.toxml())
             if not rc:
                 cnt += 1
                 self.obj_updated(obj)
             else:
                 update_err(obj.obj_id,cibadm_opt,obj.node)
                 self.all_committed = False
         return cnt
     def obj_updated(self,obj):
         obj.updated = False
         obj.origin = 'cib'
         for child in obj.children:
             self.obj_updated(child)
     def update_links(self,obj):
         '''
         Update the structure links for the object (obj.children,
         obj.parent). Update also the dom nodes, if necessary.
         '''
         obj.children = []
         if obj.obj_type not in ("group","clone","ms"):
             return
         for c in obj.node.childNodes:
             if is_element(c) and c.tagName in ("primitive","group"):
                 child = self.find_object_for_node(c)
                 if not child:
                     missing_obj_err(c)
                     continue
                 child.parent = obj
                 obj.children.append(child)
                 if not c.isSameNode(child.node):
                     child.node.parentNode.removeChild(child.node)
                     child.node.unlink()
                     child.node = c
     def populate(self):
         "Walk the cib and collect cib objects."
         all_nodes = get_interesting_nodes(self.doc,[])
         if not all_nodes:
             return
         for node in processing_sort(all_nodes):
             obj = cib_object_map[node.tagName][1](node.tagName)
             obj.origin = "cib"
             self.cib_objects.append(obj)
             if not obj.save_xml(node):
                 obj.nocli = True
         for obj in self.cib_objects:
             self.update_links(obj)
     def initialize(self):
         if self.doc:
             return True
         if not self.parse_cib():
             common_err("bad cib")
             return False
         sanitize_cib(self.doc)
         self.populate()
         return self.check_structure()
     def reset(self):
         if not self.doc:
             return
         self.doc.unlink()
         self.doc = None
         self.topnode = {}
         self.cib_attrs = {} # cib version dictionary
         self.cib_objects = [] # a list of cib objects
         self.remove_queue = [] # a list of cib objects to be removed
         self.overwrite = False # update cib unconditionally
         id_store.clear() # update cib unconditionally
     def find_object(self,obj_id):
         "Find an object."
         for obj in self.cib_objects:
             if obj.obj_id == obj_id:
                 return obj
         return None
     def id_list(self):
         "List of ids (for completion)."
         return [x.obj_id for x in self.cib_objects]
     def prim_id_list(self):
         "List of primitives ids (for group completion)."
         return [x.obj_id for x in self.cib_objects if x.obj_type == "primitive"]
     def children_id_list(self):
         "List of child ids (for clone/master completion)."
         return [x.obj_id for x in self.cib_objects if x.obj_type in children_tags]
     def rsc_id_list(self):
         "List of resource ids (for constraint completion)."
         return [x.obj_id for x in self.cib_objects if x.obj_type in resource_tags]
     def f_prim_id_list(self):
         "List of possible primitives ids (for group completion)."
         return [x.obj_id for x in self.cib_objects \
             if x.obj_type == "primitive" and not x.parent]
     def f_children_id_list(self):
         "List of possible child ids (for clone/master completion)."
         return [x.obj_id for x in self.cib_objects \
             if x.obj_type in children_tags and not x.parent]
     def find_object_for_node(self,node):
         "Find an object which matches a dom node."
         for obj in self.cib_objects:
             if node.getAttribute("id") == obj.obj_id:
                 return obj
         return None
     def new_object(self,obj_type,obj_id):
         "Create a new object of type obj_type."
         if id_in_use(obj_id):
             return None
         for xml_obj_type,v in cib_object_map.items():
             if v[0] == obj_type:
                 obj = v[1](xml_obj_type,obj_id)
                 if obj.obj_id:
                     return obj
                 else:
                     return None
         return None
     def obj_filter(self,obj,*args):
         "Filter objects."
         if not args:
             return True
         if args[0] == "NOOBJ":
             return False
         if args[0] == "changed":
             return obj.updated or obj.origin == "user"
         return obj.obj_id in args
     def mkobj_list(self,mode,*args):
         obj_list = []
         for obj in self.cib_objects:
             f = lambda: self.obj_filter(obj,*args)
             if not f():
                 continue
             if mode == "cli" and obj.nocli:
                 obj_cli_err(obj.obj_id)
                 continue
             obj_list.append(obj)
         return obj_list
     def has_cib_changed(self):
         return self.mkobj_list("xml","changed") or self.remove_queue
     def verify_constraints(self,cli_list):
         '''
         Check if all resources referenced in a constraint exist
         '''
         rc = True
         head = cli_list[0]
         constraint_id = find_value(head[1],"id")
         for obj_id in referenced_resources_cli(cli_list):
             if not self.find_object(obj_id):
                 constraint_norefobj_err(constraint_id,obj_id)
                 rc = False
         return rc
     def verify_children(self,cli_list):
         '''
         Check prerequisites:
           a) all children must exist
           b) no child may have other parent than me
           (or should we steal children?)
         '''
         head = cli_list[0]
         obj_type = head[0]
         obj_id = find_value(head[1],"id")
         c_ids = find_value(head[1],"$children")
         if not c_ids:
             return True
         for child_id in c_ids:
             if not self.verify_child(child_id,obj_type,obj_id):
                 return False
         return True
     def verify_child(self,child_id,obj_type,obj_id):
         'Check if child exists and obj_id is (or may become) its parent.'
         child = self.find_object(child_id)
         if not child:
             no_object_err(child_id)
             return False
         if child.parent and child.parent.obj_id != obj_id:
             common_err("%s already in use at %s"%(child_id,child.parent.obj_id))
             return False
         if obj_type == "group" and child.obj_type != "primitive":
             common_err("a group may contain only primitives; %s is %s"%(child_id,child.obj_type))
             return False
         if child.obj_type != "primitive" and child.obj_type != "group":
             common_err("%s may contain a primitive or a group; %s is %s"%(obj_type,child_id,child.obj_type))
             return False
         return True
     def verify_cli(self,cli_list):
         '''
         Can we create this object given its CLI representation.
         This is not about syntax, we're past that, but about
         semantics.
         Right now we check if the children, if any, are fit for
         the parent. And if this is a constraint, if all
         referenced resources are present.
         '''
         rc = True
         if not self.verify_children(cli_list):
             rc = False
         if not self.verify_constraints(cli_list):
             rc = False
         return rc
     def create_object(self,*args):
         return self.create_from_cli(parse_cli(args))
     def set_property_cli(self,cli_list):
         head_pl = cli_list[0]
         obj_type = head_pl[0]
         pset_id = find_value(head_pl[1],"$id")
         if pset_id:
             head_pl[1].remove(["$id",pset_id])
         else:
             pset_id = default_cluster_property_set
         obj = self.find_object(pset_id)
         if not obj:
             if not is_id_valid(pset_id):
                 invalid_id_err(pset_id)
                 return False
             obj = self.new_object(obj_type,pset_id)
             if not obj:
                 return False
             self.topnode[obj.parent_type].appendChild(obj.node)
             obj.origin = "user"
             self.cib_objects.append(obj)
         for n,v in head_pl[1]:
             set_property(obj.node,n,v)
         obj.updated = True
     def create_from_cli(self,cli):
         'Create a new cib object from the cli representation.'
         if type(cli) == type('') or type(cli) == type(u''):
             cli_list = parse_cli(cli)
         else:
             cli_list = cli
         if not cli_list:
             return False
         if not self.verify_cli(cli_list):
             return False
         head = cli_list[0]
         obj_type = head[0]
         if obj_type == "property":
             return self.set_property_cli(cli_list)
         obj_id = find_value(head[1],"id")
         if not is_id_valid(obj_id):
             invalid_id_err(obj_id)
             return False
         obj = self.new_object(obj_type,obj_id)
         if not obj:
             return False
         obj.node = obj.cli2node(cli_list)
         self.topnode[obj.parent_type].appendChild(obj.node)
         self.adjust_children(obj,cli_list)
         obj.origin = "user"
         for child in obj.children:
             if child.origin == "cib":
                 self.add_to_remove_queue(child)
         self.cib_objects.append(obj)
     def adjust_children(self,obj,cli_list):
         '''
         All stuff children related: manage the nodes of children,
         update the list of children for the parent, update
         parents in the children.
         '''
         head = cli_list[0]
         children_ids = find_value(head[1],"$children")
         if not children_ids:
             return
         new_children = []
         for child_id in children_ids:
             new_children.append(self.find_object(child_id))
         self._relink_orphans(obj,new_children)
         obj.children = new_children
         self._update_children(obj)
     def _relink_child(self,obj):
         'Relink a child to the top node.'
         obj.node.parentNode.removeChild(obj.node)
         self.topnode[obj.parent_type].appendChild(obj.node)
         obj.parent = None
     def _update_children(self,obj):
         '''For composite objects: update all children nodes.
         '''
         # unlink all and find them in the new node
         for child in obj.children:
             oldnode = child.node
             child.node = obj.find_child_in_node(child)
             if child.children: # and children of children
                 self._update_children(child)
             oldnode.parentNode.removeChild(oldnode)
             oldnode.unlink()
             child.parent = obj
     def _relink_orphans(self,obj,new_children):
         "New orphans move to the top level for the object type."
         for child in obj.children:
             if child not in new_children:
                 self._relink_child(child)
     def create_from_node(self,node):
         'Create a new cib object from a document node.'
         if not node:
             return True
         obj = self.new_object(node.tagName,node.getAttribute("id"))
         if not obj:
             return False
         node = self.doc.importNode(node,1)
         self.topnode[obj.parent_type].appendChild(node)
         if not obj.save_xml(node):
             obj.nocli = True
         self.update_links(obj)
         obj.origin = "user"
         self.cib_objects.append(obj)
     def cib_objects_string(self):
         l = []
         for obj in self.cib_objects:
             l.append(obj.obj_string())
         return ' '.join(l)
     def _remove_obj(self,obj):
         "Remove a cib object and its children."
         # remove children first
         # can't remove them here from obj.children!
         for child in obj.children:
             self._remove_obj(child)
         id_store.remove_xml(obj.node)
         obj.node.parentNode.removeChild(obj.node)
         obj.node.unlink()
         self.cib_objects.remove(obj)
     def related_constraints(self,obj):
         if not is_resource(obj.node):
             return []
         c_list = []
         for obj2 in self.cib_objects:
             if not is_constraint(obj2.node):
                 continue
             if rsc_constraint(obj.obj_id,obj2.node):
                 c_list.append(obj2)
         return c_list
     def add_to_remove_queue(self,obj):
         self.remove_queue.append(obj)
         self.remove_queue += self.related_constraints(obj)
         #for obj in self.remove_queue: print obj.obj_string()
     def delete(self,*args):
         'Delete a cib object.'
         rc = True
         l = []
         for obj_id in args:
             obj = self.find_object(obj_id)
             if not obj:
                 no_object_err(obj_id)
                 rc = False
                 continue
             l.append(obj)
         for obj in l:
             # remove the parent for which this object is the
             # only child: empty containers are of no use and not
             # allowed
             while obj.parent:
                 if len(obj.parent.children) > 1:
                     break
                 else:
                     obj = obj.parent
             # recurse in another function; otherwise the previous
             # code would make an infinite loop
             self._remove_obj(obj)
             #print "remove",obj.obj_string()
             obj.children = []  # children are gone
             if obj.origin == "cib":
                 self.add_to_remove_queue(obj)
         return rc
     def rename(self,old_id,new_id):
         '''
         Rename a cib object.
         - check if the resource (if it's a resource) is stopped
         - check if the new id is not taken
         - find the object with old id
         - rename old id to new id in all related objects
           (constraints)
         - rename old id to new id in the object
         '''
         if id_in_use(new_id):
             return False
         obj = self.find_object(old_id)
         if not obj:
             no_object_err(old_id)
             return False
         if is_resource(obj.node) and is_rsc_running(old_id):
             common_err("sorry, cannot rename a running resource (%s)" % old_id)
             return False
         for c_obj in self.related_constraints(obj):
             rename_rscref(c_obj.node,old_id,new_id)
             c_obj.updated = True
         rename_id(obj.node,old_id,new_id)
         obj.obj_id = new_id
         id_store.rename(old_id,new_id)
         obj.updated = True
         obj.propagate_updated()
     def erase(self):
         "Remove all cib objects."
         # find only topmost objects
         for obj in [obj for obj in self.cib_objects if not obj.parent]:
             self.delete(obj.obj_id)
         if self.cib_objects:
             common_err("strange, but these objects remained:")
             for obj in self.cib_objects:
                 print obj.obj_string()
             self.cib_objects = []
     def refresh(self):
         "Refresh from the CIB."
         self.reset()
         self.initialize()
 
 class TopLevel(object):
     '''
     The top level.
     '''
     help_table = odict()
     help_table["."] = ("","""This is the CRM command line interface program.""")
     help_table["cib"] = ("manage shadow CIBs", """
 A shadow CIB is a regular cluster configuration which is kept in
 a file. The CRM and the CRM tools may manage a shadow CIB in the
 same way as the live CIB (i.e. the current cluster configuration).
 A shadow CIB may be applied to the cluster in one step.
 """)
     help_table["resource"] = ("resources management", """
 Everything related to resources management is available at this
 level. Most commands are implemented using the crm_resource(8)
 program.
 """)
     help_table["node"] = ("nodes management", """
 A few node related tasks such as node standby are implemented
 here.
 """)
     help_table["options"] = ("user preferences", """
 Several user preferences are available. Note that it is possible
 to save the preferences to a startup file.
 """)
     help_table["configure"] = ("CRM cluster configuration", """
 The configuration level.
 
 Note that you can change the working CIB at the cib level. It is
 advisable to configure shadow CIBs and then commit them to the
 cluster.
 """)
     help_table["quit"] = ("exit the program", "")
     help_table["help"] = ("show help", "")
     help_table["end"] = ("go back one level", "")
     def __init__(self):
         self.cmd_table = {
             'cib': CibShadow,
             'resource': RscMgmt,
             'configure': CibConfig,
             'node': NodeMgmt,
             'options': CliOptions,
             'status': (self.status,(0,0),0),
             'quit': (cmd_exit,(0,0),0),
             'help': (self.help,(0,1),0),
             'end': (cmd_end,(0,0),0),
         }
     def help(self,cmd,topic = ''):
         cmd_help(self.help_table,topic)
     def status(self,cmd):
         return ext_cmd("crm_mon -1")
 
 def attr_cmds(delimiter = False):
     if delimiter:
         return ' '
     return ["delete","set","show"]
 def listnodes(delimiter = False):
     if delimiter:
         return ' '
     if wcache.is_cached("listnodes"):
         return wcache.retrieve("listnodes")
     nodes = []
     doc = xml2doc("%s -o nodes"%cib_dump)
     if not doc:
         return []
     nodes_node = get_cib_elem(doc, "nodes")
     for c in nodes_node.childNodes:
         if not is_element(c):
             continue
         if c.tagName != "node":
             continue
         if c.getAttribute("type") == 'normal':
             nodes.append(c.getAttribute("uname"))
     return wcache.store("property_list",nodes)
 def rsc_list(delimiter = False):
     if delimiter:
         return ' '
     if wcache.is_cached("rsc_list"):
         return wcache.retrieve("rsc_list")
     doc = xml2doc("%s -o resources" % cib_dump)
     if not doc:
         return []
     nodes = get_interesting_nodes(doc,[])
     l = [x.getAttribute("id") for x in nodes if is_resource(x)]
     return wcache.store("rsc_list",l)
 def null_list(delimiter = False):
     if delimiter:
         return ' '
     return []
 def loop(delimiter = False):
     "just a marker in a list"
     if delimiter:
         return ' '
     return []
 def id_list_xml(delimiter = False):
     if delimiter:
         return ' '
     l = cib_factory.id_list()
     l.append("xml")
     return l
 def id_list(delimiter = False):
     if delimiter:
         return ' '
     return cib_factory.id_list()
 def f_prim_id_list(delimiter = False):
     if delimiter:
         return ' '
     return cib_factory.f_prim_id_list()
 def f_children_id_list(delimiter = False):
     if delimiter:
         return ' '
     return cib_factory.f_children_id_list()
 def rsc_id_list(delimiter = False):
     if delimiter:
         return ' '
     return cib_factory.rsc_id_list()
 def skills_list(delimiter = False):
     if delimiter:
         return ' '
     return CliOptions.skill_levels.keys()
 def property_list(delimiter = False):
     if delimiter:
         return '='
     if wcache.is_cached("property_list"):
         return wcache.retrieve("property_list")
     doc = xml2doc("@hb_libdir@/pengine metadata")
     if not doc:
         return []
     l = []
     for node in doc.getElementsByTagName("parameter"):
         p = node.getAttribute("name")
         if p:
             l.append(p)
     doc.unlink()
     return wcache.store("property_list",l)
 def topics_dict(help_tab):
     topics = {}
     for topic in help_tab:
         if topic != '.':
             topics[topic] = None
     return topics
 
 def mk_completion_tab(cmd_class,ctab):
     obj = cmd_class()
     cmd_table = obj.cmd_table
     for key,value in cmd_table.items():
         if key.startswith("_"):
             continue
         if type(value) == type(object):
             ctab[key] = {}
             mk_completion_tab(value,ctab[key])
         elif key == "help":
             ctab[key] = topics_dict(obj.help_table)
         else:
             ctab[key] = None
             try: ctab[key] = value[3]
             except: pass
 def lookup_dynamic(fun_list,idx,words):
     if not fun_list:
         return []
     if fun_list[idx] == loop:
         idx -= 1
     f = fun_list[idx]
     w = words[0]
     wordlist = f()
     delimiter = f(1)
     if len(words) == 1:
         return [x+delimiter for x in wordlist if x.startswith(w)]
     elif w in wordlist or f == null_list:
         return lookup_dynamic(fun_list,idx+1,words[1:])
     return []
 def lookup_words(ctab,words):
     if not ctab:
         return []
     if type(ctab) == type(()):
         return lookup_dynamic(ctab,0,words)
     if len(words) == 1:
         return [x+' ' for x in ctab if x.startswith(words[0])]
     elif words[0] in ctab.keys():
         return lookup_words(ctab[words[0]],words[1:])
     return []
 def completer(txt,state):
     words = readline.get_line_buffer().split()
     if not words or readline.get_line_buffer()[-1] == ' ':
         words.append('')
     matched = lookup_words(levels.completion_tab,words)
     matched.append(None)
     return matched[state]
 
 wcache = WCache()
 err_buf = ErrorBuffer()
 user_prefs = UserPrefs()
 id_store = IdMgmt()
 cib_factory = CibFactory()
 tmpfiles = []
 
 def load_rc(rcfile):
     try: f = open(rcfile)
     except: return
     save_stdin = sys.stdin
     sys.stdin = f
     while True:
         inp = multi_input()
         if inp == None:
             break
         try: parse_line(levels,shlex.split(inp))
         except ValueError, msg:
             common_err(msg)
     f.close()
     sys.stdin = save_stdin
 
 def multi_input(prompt = ''):
     """
     Get input from user
     Allow multiple lines using a continuation character
     """
     line = []
     while True:
         try:
             text = raw_input(prompt)
         except EOFError:
             return None
         stripped = text.strip()
         if stripped.endswith('\\'):
             stripped = stripped.rstrip('\\')
             line.append(stripped)
             if prompt:
                 prompt = '> '
         else:
             line.append(stripped)
             break
     return ''.join(line)
 
 class Levels(object):
     '''
     Keep track of levels and prompts.
     '''
     def __init__(self,start_level):
         self._marker = 0
         self._in_transit = False
         self.level_stack = []
         self.comp_stack = []
         self.current_level = start_level()
         self.parse_root = self.current_level.cmd_table
         self.prompts = []
         self.completion_tab = {}
         mk_completion_tab(start_level,self.completion_tab)
     def getprompt(self):
         return ' '.join(self.prompts)
     def mark(self):
         self._marker = len(self.level_stack)
         self._in_transit = False
     def release(self):
         while len(self.level_stack) > self._marker:
             self.droplevel()
     def new_level(self,level_obj,token):
         self.level_stack.append(self.current_level)
         self.comp_stack.append(self.completion_tab)
         self.prompts.append(token)
         self.current_level = level_obj()
         self.parse_root = self.current_level.cmd_table
         self.completion_tab = self.completion_tab[token]
         self._in_transit = True
     def droplevel(self):
         if self.level_stack:
             try: self.current_level.end_game(self._in_transit)
             except: pass
             self.current_level = self.level_stack.pop()
             self.completion_tab = self.comp_stack.pop()
             self.parse_root = self.current_level.cmd_table
             self.prompts.pop()
 
 def check_args(args,argsdim):
     if not argsdim: return True
     if len(argsdim) == 1:
         minargs = argsdim[0]
         return len(args) >= minargs
     else:
         minargs,maxargs = argsdim
         return len(args) >= minargs and len(args) <= maxargs
 
 #
 # Note on parsing
 #
 # Parsing tables are python dictionaries.
 #
 # Keywords are used as keys and the corresponding values are
 # lists (actually tuples, since they should be read-only) or
 # classes. In the former case, the keyword is a terminal and
 # in the latter, a new object for the class is created. The class
 # must have the cmd_table variable.
 #
 # The list has the following content:
 #
 # function: a function to handle this command
 # numargs_list: number of minimum/maximum arguments; for example,
 #   (0,1) means one optional argument, (1,1) one required; if the
 #   list is empty then the function will parse arguments itself
 # required minimum skill level: operator, administrator, expert
 #   (encoded as a small integer from 0 to 2)
 # 
 
 def show_usage(cmd):
     p = None
     try: p = cmd.__doc__
     except: pass
     if p:
         print p
     else:
         syntax_err(cmd.__name__)
 
 def parse_line(lvl,s):
     if not s: return True
     if s[0].startswith('#'): return True
     lvl.mark()
     pt = lvl.parse_root
     cmd = None
     i = 0
     for i in range(len(s)):
         token = s[i]
         if token in pt:
             if type(pt[token]) == type(object):
                 lvl.new_level(pt[token],token)
                 pt = lvl.parse_root # move to the next level
             else:
                 cmd = pt[token] # terminal symbol
                 break  # and stop parsing
         else:
             syntax_err(s[i:])
             lvl.release()
             return False
     if cmd: # found a terminal symbol
         if not user_prefs.check_skill_level(cmd[2]):
             lvl.release()
             skill_err(s[i])
             return False
         args = s[i+1:]
         if not check_args(args,cmd[1]):
             lvl.release()
             show_usage(cmd[0])
             return False
         args = s[i:]
         d = lambda: cmd[0](*args)
         rv = d() # execute the command
         lvl.release()
         return rv != False
 
 # three modes: interactive (no args supplied), batch (input from
 # a file), half-interactive (args supplied, but not batch)
 interactive = True
 batch = False
 inp_file = ''
 prompt = ''
 cib_in_use = os.getenv(CibShadow().envvar)
 def cib_prompt():
     return cib_in_use or "live"
 
 def usage():
     print """
 usage:
     crm
     crm args
     crm [-f file]
 
     Use crm without arguments for an interactive session.
     Supply one or more arguments for a "single-shot" use.
     Specify with -f a file which contains a script. Use '-' for
     standard input or use pipe/redirection.
 
 Examples:
 
     # crm -f stopapp2.cli
     # crm < stopapp2.cli
     # crm resource stop global_www
     # crm status 
 
     """
     sys.exit(1)
 
 def prereqs():
     proglist = "cibadmin crm_resource crm_attribute crm_mon crm_standby crm_failcount"
     for prog in proglist.split():
         if not is_program(prog):
             no_prog_err(prog)
             sys.exit(1)
 
 prereqs()
 hist_file = os.environ.get('HOME')+"/.crm_history"
 rc_file = os.environ.get('HOME')+"/.crm.rc"
 readline.set_history_length(100)
 readline.parse_and_bind("tab: complete")
 readline.set_completer(completer)
 readline.set_completer_delims(\
     readline.get_completer_delims().replace('-',''))
 try: readline.read_history_file(hist_file)
 except: pass
 build_completions = True
 levels = Levels(TopLevel)
 build_completions = False
 load_rc(rc_file)
 
 argc = len(sys.argv)
 if argc > 1:
     interactive = False
     if sys.argv[1] == "-f":
         batch = True
         if argc != 3:
             usage()
         inp_file = sys.argv[2]
     elif sys.argv[1] == "-h" or sys.argv[1] == "--help":
         usage()
     else:
         args = sys.argv[1:]
         if parse_line(levels,args):
             sys.exit(0)
         else:
             sys.exit(1)
 
 if not sys.stdin.isatty():
     interactive = False
     batch = True
 
 if inp_file == "-":
     pass
 elif inp_file:
     try:
         f = open(inp_file)
     except IOError, msg:
         common_err(msg)
         usage()
     sys.stdin = f
 
 while True:
     if interactive:
         prompt = "crm(%s)%s# " % (cib_prompt(),levels.getprompt())
     inp = multi_input(prompt)
     if inp == None:
         cmd_exit("eof")
     try: parse_line(levels,shlex.split(inp))
     except ValueError, msg:
         common_err(msg)
 
 # vim:ts=4:sw=4:et: