On Sat, Dec 16, 2023 at 05:39:12PM -0800, Atish Kumar Patra wrote: > On Thu, Dec 7, 2023 at 5:06 AM Conor Dooley <conor.dooley@xxxxxxxxxxxxx> wrote: > > On Mon, Dec 04, 2023 at 06:43:07PM -0800, Atish Patra wrote: > > > +static void pmu_sbi_snapshot_free(struct riscv_pmu *pmu) > > > +{ > > > + int cpu; > > > > > + struct cpu_hw_events *cpu_hw_evt; > > > > This is only used inside the scope of the for loop. > > > > Do you intend to suggest using mixed declarations ? Personally, I > prefer all the declarations upfront for readability. > Let me know if you think that's an issue or violates coding style. I was suggesting int cpu; for_each_possible_cpu(cpu) struct cpu_hw_events *cpu_hw_evt = per....() I've been asked to do this in some subsystems I submitted code to, and checkpatch etc do not complain about it. I don't think there is any specific commentary in the coding style about minimising the scope of variables however. > > > + /* Free up the snapshot area memory and fall back to default SBI */ > > > > What does "fall back to the default SBI mean"? SBI is an interface so I > > don't understand what it means in this context. Secondly, > > In absence of SBI PMU snapshot, the driver would try to read the > counters directly and end up traps. > Also, it would not use the SBI PMU snapshot flags in the SBI start/stop calls. > Snapshot is an alternative mechanism to minimize the traps. I just > wanted to highlight that. > > How about this ? > "Free up the snapshot area memory and fall back to default SBI PMU > calls without snapshot */ Yeah, that's fine (modulo the */ placement). The original comment just seemed truncated. > > > + if (ret.error) { > > > + if (ret.error != SBI_ERR_NOT_SUPPORTED) > > > + pr_warn("%s: pmu snapshot setup failed with error %ld\n", __func__, > > > + ret.error); > > > > Why is the function relevant here? Is the error message in-and-of-itself > > not sufficient here? Where else would one be setting up the snapshots > > other than the setup function? > > > > The SBI implementation (i.e OpenSBI) may or may not provide a snapshot > feature. This error message indicates > that SBI implementation supports PMU snapshot but setup failed for > some other error. I don't see what this has to do with printing out the function. This is a unique error message, and there is no other place where the setup is done AFAICT. > > > + /* Snapshot is taken relative to the counter idx base. Apply a fixup. */ > > > + if (hwc->idx > 0) { > > > + sdata->ctr_values[hwc->idx] = sdata->ctr_values[0]; > > > + sdata->ctr_values[0] = 0; > > > > Why is this being zeroed in this manner? Why is zeroing it not required > > if hwc->idx == 0? You've got a comment there that could probably do with > > elaboration. > > > > hwc->idx is the counter_idx_base here. If it is zero, that means the > counter0 value is updated > in the shared memory. However, if the base > 0, we need to update the > relative counter value > from the shared memory. Does it make sense ? Please expand on the comment so that it contains this information. > > > + ret = pmu_sbi_snapshot_setup(pmu, smp_processor_id()); > > > + if (!ret) { > > > + pr_info("SBI PMU snapshot is available to optimize the PMU traps\n"); > > > > Why the verbose message? Could we standardise on one wording for the SBI > > function probing stuff? Most users seem to be "SBI FOO extension detected". > > Only IPI has additional wording and PMU differs slightly. > > Additional information is for users to understand PMU functionality > uses less traps on this system. > We can just resort to and expect users to read upon the purpose of the > snapshot from the spec. > "SBI PMU snapshot available" What I was asking for was alignment with the majority of other SBI extensions that use the format I mentioned above. > > > > > > + /* We enable it once here for the boot cpu. If snapshot shmem fails during > > > > Again, comment style here. What does "snapshot shmem" mean? I think > > there's a missing action here. Registration? Allocation? > > > > Fixed it. It is supposed to be "snapshot shmem setup" > > > > + * cpu hotplug on, it should bail out. > > > > Should or will? What action does "bail out" correspond to? > > > > bail out the cpu hotplug process. We don't support heterogeneous pmus > for snapshot. > If the SBI implementation returns success for SBI_EXT_PMU_SNAPSHOT_SET_SHMEM > boot cpu but fails for other cpus while bringing them up, it is > problematic to handle that. "bail out" should be replaced by a more technical explanation of what is going to happen. "should" is a weird word to use, either the cpuhotplug code does or does not deal with this case, and since that code is also in the kernel, this patchset should ensure that it does handle the case, no? If the kernel does handle it "should" should be replaced with more definitive wording. Thanks, Conor.
Attachment:
signature.asc
Description: PGP signature