3 # Copyright (c) 2003 Intel Corporation
6 # Copyright (c) 2004-2006 The Trustees of Princeton University
8 # expected /proc/partitions format
10 import os, sys, shutil
18 from Exceptions import *
21 # the simplest way to debug is to let the node take off,
22 # ssh into it as root using the debug ssh key in /etc/planetlab
23 # then go to /tmp/source
24 # edit this file locally to turn on breakpoints if needed, then run
28 ### handling breakpoints in the startup process
29 import select, sys, string
31 ### global debugging settings
33 # enabling this will cause the node to ask for breakpoint-mode at startup
34 # production code should read False/False
36 # default for when prompt is turned off, or it's on but the timeout triggers
39 # verbose mode is just fine
41 # in seconds : if no input, proceed
44 def prompt_for_breakpoint_mode ():
46 global BREAKPOINT_MODE
48 default_answer=BREAKPOINT_MODE
54 sys.stdout.write ("Want to run in breakpoint mode ? %s "%display)
56 r,w,e = select.select ([sys.stdin],[],[],PROMPT_TIMEOUT)
58 answer = string.strip(sys.stdin.readline())
60 sys.stdout.write("\nTimed-out (%d s)"%PROMPT_TIMEOUT)
62 BREAKPOINT_MODE = ( answer == "y" or answer == "Y")
64 BREAKPOINT_MODE = default_answer
68 sys.stdout.write("\nCurrent BREAKPOINT_MODE is %s\n"%label)
70 def breakpoint (message, cmd = None):
76 message=message+" -- Entering bash - type ^D to proceed"
82 ########################################
85 from python docs for os.makedirs:
86 Throws an error exception if the leaf directory
87 already exists or cannot be created.
89 That is real useful. Instead, we'll create the directory, then use a
90 separate function to test for its existance.
92 Return 1 if the directory exists and/or has been created, a BootManagerException
93 otherwise. Does not test the writability of said directory.
102 raise BootManagerException, "Unable to create directory tree: %s" % path
108 def removedir( path ):
110 remove a directory tree, return 1 if successful, a BootManagerException
119 shutil.rmtree( path )
120 except OSError, desc:
121 raise BootManagerException, "Unable to remove directory tree: %s" % path
126 def sysexec( cmd, log=None, fsck=False, shell=False ):
128 execute a system command, output the results to the logger
131 return 1 if command completed (return code of non-zero),
132 0 if failed. A BootManagerException is raised if the command
133 was unable to execute or was interrupted by the user with Ctrl+C
136 # Thierry - Jan. 6 2011
137 # would probably make sense to look for | here as well
138 # however this is fragile and hard to test thoroughly
139 # let the caller set 'shell' when that is desirable
140 if shell or cmd.__contains__(">"):
141 prog = subprocess.Popen(cmd, shell=True)
143 print ("sysexec (shell mode) >>> %s" % cmd)
145 prog = subprocess.Popen(shlex.split(cmd), stdout=subprocess.PIPE, stderr=subprocess.PIPE)
147 print ("sysexec >>> %s" % cmd)
149 raise BootManagerException, \
150 "Unable to create instance of subprocess.Popen " \
151 "for command: %s" % cmd
153 (stdoutdata, stderrdata) = prog.communicate()
154 except KeyboardInterrupt:
155 raise BootManagerException, "Interrupted by user"
158 if stdoutdata is not None:
159 log.write(stdoutdata)
161 returncode = prog.wait()
164 # The exit code returned by fsck is the sum of the following conditions:
166 # 1 - File system errors corrected
167 # 2 - System should be rebooted
168 # 4 - File system errors left uncorrected
169 # 8 - Operational error
170 # 16 - Usage or syntax error
171 # 32 - Fsck canceled by user request
172 # 128 - Shared library error
173 if returncode != 0 and returncode != 1:
174 raise BootManagerException, "Running %s failed (rc=%d)" % (cmd,returncode)
177 raise BootManagerException, "Running %s failed (rc=%d)" % (cmd,returncode)
183 def sysexec_chroot( path, cmd, log=None, shell=False):
185 same as sysexec, but inside a chroot
188 release = os.uname()[2]
189 # 2.6.12 kernels need this
190 if release[:5] == "2.6.1":
191 library = "%s/lib/libc-opendir-hack.so" % path
192 if not os.path.exists(library):
193 shutil.copy("./libc-opendir-hack.so", library)
194 preload = "/bin/env LD_PRELOAD=/lib/libc-opendir-hack.so"
195 sysexec("chroot %s %s %s" % (path, preload, cmd), log, shell=shell)
198 def sysexec_chroot_noerr( path, cmd, log=None, shell=False ):
200 same as sysexec_chroot, but capture boot manager exceptions
204 rc= sysexec_chroot( cmd, log, shell=shell )
205 except BootManagerException, e:
211 def sysexec_noerr( cmd, log=None, shell=False ):
213 same as sysexec, but capture boot manager exceptions
217 rc= sysexec( cmd, log, shell=shell )
218 except BootManagerException, e:
227 change to a directory, return 1 if successful, a BootManagerException if failure
232 raise BootManagerException, "Unable to change to directory: %s" % dir
238 def removefile( filepath ):
240 removes a file, return 1 if successful, 0 if failure
243 os.remove( filepath )
245 raise BootManagerException, "Unable to remove file: %s" % filepath
251 # from: http://forums.devshed.com/archive/t-51149/
252 # Ethernet-card-address-Through-Python-or-C
255 return "%02x" % (ord(n))
257 def get_mac_from_interface(ifname):
259 given a device name, like eth0, return its mac_address.
260 return None if the device doesn't exist.
263 SIOCGIFHWADDR = 0x8927 # magic number
265 s=socket.socket(socket.AF_INET,socket.SOCK_STREAM)
266 ifname = string.strip(ifname)
267 ifr = ifname + '\0'*(32-len(ifname))
270 r= fcntl.ioctl(s.fileno(),SIOCGIFHWADDR,ifr)
271 addr = map(hexy,r[18:24])
272 ret = (':'.join(map(str, addr)))
278 def check_file_hash(filename, hash_filename):
279 """Check the file's integrity with a given hash."""
280 return sha1_file(filename) == open(hash_filename).read().split()[0].strip()
282 def sha1_file(filename):
283 """Calculate sha1 hash of file."""
291 f = file(filename, 'rb')
293 # 256 KB seems ideal for speed/memory tradeoff
294 # It wont get much faster with bigger blocks, but
296 block = f.read(256 * 1024)
301 # Simple trick to keep total heap even lower
302 # Delete the previous block, so while next one is read
303 # we wont have two allocated blocks with same size
307 raise BootManagerException, "Cannot calculate SHA1 hash of %s" % filename