1*4f1223e8SApple OSS Distributions# A basic Plugin that creates performance reports from zprint output 2*4f1223e8SApple OSS Distributionskern_version = None 3*4f1223e8SApple OSS Distributions 4*4f1223e8SApple OSS Distributionsdef plugin_init(kernel_target, config, lldb_obj, isConnected): 5*4f1223e8SApple OSS Distributions """ initialize the common data as required by plugin """ 6*4f1223e8SApple OSS Distributions global kern_version 7*4f1223e8SApple OSS Distributions kern_version = str(kernel_target.version) 8*4f1223e8SApple OSS Distributions 9*4f1223e8SApple OSS Distributionsdef plugin_execute(command_name, result_output): 10*4f1223e8SApple OSS Distributions """ The xnu framework will call this function with output of a command. 11*4f1223e8SApple OSS Distributions The options for returning are as follows 12*4f1223e8SApple OSS Distributions returns: (status, outstr, further_cmds) 13*4f1223e8SApple OSS Distributions status: Boolean - specifying whether plugin execution succeeded(True) or failed. If failed then xnu will stop doing any further work with this command. 14*4f1223e8SApple OSS Distributions outstr: str - string output for user to be printed at the prompt 15*4f1223e8SApple OSS Distributions further_cmds: [] of str - this holds set of commands to execute at the lldb prompt. Empty array if nothing is required. 16*4f1223e8SApple OSS Distributions """ 17*4f1223e8SApple OSS Distributions status = True 18*4f1223e8SApple OSS Distributions outstr = 'Nothing to be done here' 19*4f1223e8SApple OSS Distributions further_cmds = [] 20*4f1223e8SApple OSS Distributions further_cmds.append("memstats -- --plugin zprint_perf_log ") 21*4f1223e8SApple OSS Distributions 22*4f1223e8SApple OSS Distributions if command_name != 'zprint' : 23*4f1223e8SApple OSS Distributions status = False 24*4f1223e8SApple OSS Distributions else: 25*4f1223e8SApple OSS Distributions num_zones = len(result_output.split("\n")) -1 26*4f1223e8SApple OSS Distributions outstr += "Num of zones analyzed =" + str(num_zones) + "\n" 27*4f1223e8SApple OSS Distributions return (status, outstr, further_cmds) 28*4f1223e8SApple OSS Distributions 29*4f1223e8SApple OSS Distributionsdef plugin_cleanup(): 30*4f1223e8SApple OSS Distributions """ A cleanup call from xnu which is a signal to wrap up any open file descriptors etc. """ 31*4f1223e8SApple OSS Distributions return None 32