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 log.write("sysexec (shell mode) >>> %s" % cmd)
145 print "sysexec (shell mode) >>> %s" % cmd
147 prog = subprocess.Popen(shlex.split(cmd), stdout=subprocess.PIPE, stderr=subprocess.PIPE)
149 log.write("sysexec >>> %s\n" % cmd)
151 print "sysexec >>> %s" % cmd
153 raise BootManagerException, \
154 "Unable to create instance of subprocess.Popen " \
155 "for command: %s" % cmd
157 (stdoutdata, stderrdata) = prog.communicate()
158 except KeyboardInterrupt:
159 raise BootManagerException, "Interrupted by user"
161 # log stdout & stderr
164 log.write("==========stdout\n"+stdoutdata)
166 log.write("==========stderr\n"+stderrdata)
168 returncode = prog.wait()
171 # The exit code returned by fsck is the sum of the following conditions:
173 # 1 - File system errors corrected
174 # 2 - System should be rebooted
175 # 4 - File system errors left uncorrected
176 # 8 - Operational error
177 # 16 - Usage or syntax error
178 # 32 - Fsck canceled by user request
179 # 128 - Shared library error
180 if returncode != 0 and returncode != 1:
181 raise BootManagerException, "Running %s failed (rc=%d)" % (cmd,returncode)
184 raise BootManagerException, "Running %s failed (rc=%d)" % (cmd,returncode)
190 def sysexec_chroot( path, cmd, log=None, shell=False):
192 same as sysexec, but inside a chroot
195 release = os.uname()[2]
196 # 2.6.12 kernels need this
197 if release[:5] == "2.6.1":
198 library = "%s/lib/libc-opendir-hack.so" % path
199 if not os.path.exists(library):
200 shutil.copy("./libc-opendir-hack.so", library)
201 preload = "/bin/env LD_PRELOAD=/lib/libc-opendir-hack.so"
202 sysexec("chroot %s %s %s" % (path, preload, cmd), log, shell=shell)
205 def sysexec_chroot_noerr( path, cmd, log=None, shell=False ):
207 same as sysexec_chroot, but capture boot manager exceptions
211 rc= sysexec_chroot( cmd, log, shell=shell )
212 except BootManagerException, e:
218 def sysexec_noerr( cmd, log=None, shell=False ):
220 same as sysexec, but capture boot manager exceptions
224 rc= sysexec( cmd, log, shell=shell )
225 except BootManagerException, e:
234 change to a directory, return 1 if successful, a BootManagerException if failure
239 raise BootManagerException, "Unable to change to directory: %s" % dir
245 def removefile( filepath ):
247 removes a file, return 1 if successful, 0 if failure
250 os.remove( filepath )
252 raise BootManagerException, "Unable to remove file: %s" % filepath
258 # from: http://forums.devshed.com/archive/t-51149/
259 # Ethernet-card-address-Through-Python-or-C
262 return "%02x" % (ord(n))
264 def get_mac_from_interface(ifname):
266 given a device name, like eth0, return its mac_address.
267 return None if the device doesn't exist.
270 SIOCGIFHWADDR = 0x8927 # magic number
272 s=socket.socket(socket.AF_INET,socket.SOCK_STREAM)
273 ifname = string.strip(ifname)
274 ifr = ifname + '\0'*(32-len(ifname))
277 r= fcntl.ioctl(s.fileno(),SIOCGIFHWADDR,ifr)
278 addr = map(hexy,r[18:24])
279 ret = (':'.join(map(str, addr)))
285 def check_file_hash(filename, hash_filename):
286 """Check the file's integrity with a given hash."""
287 return sha1_file(filename) == open(hash_filename).read().split()[0].strip()
289 def sha1_file(filename):
290 """Calculate sha1 hash of file."""
298 f = file(filename, 'rb')
300 # 256 KB seems ideal for speed/memory tradeoff
301 # It wont get much faster with bigger blocks, but
303 block = f.read(256 * 1024)
308 # Simple trick to keep total heap even lower
309 # Delete the previous block, so while next one is read
310 # we wont have two allocated blocks with same size
314 raise BootManagerException, "Cannot calculate SHA1 hash of %s" % filename