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