int poke_int3_handler(struct pt_regs *regs)
 {
-       /* bp_patching_in_progress */
+       /*
+        * Having observed our INT3 instruction, we now must observe
+        * bp_patching_in_progress.
+        *
+        *      in_progress = TRUE              INT3
+        *      WMB                             RMB
+        *      write INT3                      if (in_progress)
+        *
+        * Idem for bp_int3_handler.
+        */
        smp_rmb();
 
        if (likely(!bp_patching_in_progress))
        bp_int3_addr = (u8 *)addr + sizeof(int3);
        bp_patching_in_progress = true;
        /*
-        * Corresponding read barrier in int3 notifier for
-        * making sure the in_progress flags is correctly ordered wrt.
-        * patching
+        * Corresponding read barrier in int3 notifier for making sure the
+        * in_progress and handler are correctly ordered wrt. patching.
         */
        smp_wmb();
 
        text_poke(addr, opcode, sizeof(int3));
 
        on_each_cpu(do_sync_core, NULL, 1);
-
+       /*
+        * sync_core() implies an smp_mb() and orders this store against
+        * the writing of the new instruction.
+        */
        bp_patching_in_progress = false;
-       smp_wmb();
 
        return addr;
 }