lib/prog_loading: introduce prog_segment_loaded()

In order to not muddle arch vs chipset implementations provide
a generic prog_segment_loaded() which calls platform_segment_loaded()
and arch_segment_loaded() in that order. This allows the arch variants
to live in src/arch while the chipset/platform code can implement
their own.

Change-Id: I17b6497219ec904d92bd286f18c9ec96b2b7af25
Signed-off-by: Aaron Durbin <adurbin@chromium.org>
Reviewed-on: https://review.coreboot.org/14214
Reviewed-by: Furquan Shaikh <furquan@google.com>
Tested-by: build bot (Jenkins)
Reviewed-by: Paul Menzel <paulepanter@users.sourceforge.net>
Reviewed-by: Andrey Petrov <andrey.petrov@intel.com>

src/arch/x86/postcar_loader.c

@@ -115,7 +115,7 @@ void run_postcar_phase(struct postcar_frame *pcf)
 	 * Signal to rest of system that another update was made to the
 	 * postcar program prior to running it.
 	 */
-	arch_segment_loaded((uintptr_t)rsl.params, sizeof(uintptr_t),
+	prog_segment_loaded((uintptr_t)rsl.params, sizeof(uintptr_t),
 		SEG_FINAL);
 
 	prog_run(&prog);

src/drivers/intel/fsp2_0/util.c

@@ -132,7 +132,7 @@ enum cb_err fsp_load_binary(struct fsp_header *hdr,
 		return CB_ERR;
 
 	/* Signal that FSP component has been loaded. */
-	arch_segment_loaded(hdr->image_base, hdr->image_size, SEG_FINAL);
+	prog_segment_loaded(hdr->image_base, hdr->image_size, SEG_FINAL);
 
 	return CB_SUCCESS;
 }

src/include/program_loading.h

@@ -37,8 +37,15 @@ enum prog_type {
 	PROG_BL32,
 };
 
-/* Called for each segment of a program loaded. The SEG_FINAL flag will be
- * set on the last segment loaded. */
+/*
+ * prog_segment_loaded() is called for each segment of a program loaded. The
+ * SEG_FINAL flag will be set on the last segment loaded. The following two
+ * functions, platform_segment_loaded() and arch_segment_loaded(), are called
+ * in that order within prog_segment_loaded(). In short, rely on
+ * prog_segment_loaded() to perform the proper dispatch sequence.
+ */
+void prog_segment_loaded(uintptr_t start, size_t size, int flags);
+void platform_segment_loaded(uintptr_t start, size_t size, int flags);
 void arch_segment_loaded(uintptr_t start, size_t size, int flags);
 
 /* Return true if arch supports bounce buffer.  */

src/lib/cbfs.c

@@ -206,7 +206,7 @@ int cbfs_prog_stage_load(struct prog *pstage)
 	/* Clear area not covered by file. */
 	memset(&load[fsize], 0, stage.memlen - fsize);
 
-	arch_segment_loaded((uintptr_t)load, stage.memlen, SEG_FINAL);
+	prog_segment_loaded((uintptr_t)load, stage.memlen, SEG_FINAL);
 
 out:
 	prog_set_area(pstage, load, stage.memlen);

src/lib/prog_ops.c

@@ -17,6 +17,18 @@
 #include <program_loading.h>
 
 /* For each segment of a program loaded this function is called*/
+void prog_segment_loaded(uintptr_t start, size_t size, int flags)
+{
+	platform_segment_loaded(start, size, flags);
+	arch_segment_loaded(start, size, flags);
+}
+
+void __attribute__ ((weak)) platform_segment_loaded(uintptr_t start,
+							size_t size, int flags)
+{
+	/* do nothing */
+}
+
 void __attribute__ ((weak)) arch_segment_loaded(uintptr_t start, size_t size,
 						int flags)
 {

src/lib/rmodule.c

@@ -197,7 +197,7 @@ int rmodule_load(void *base, struct rmodule *module)
 		return -1;
 	rmodule_clear_bss(module);
 
-	arch_segment_loaded((uintptr_t)module->location,
+	prog_segment_loaded((uintptr_t)module->location,
 				rmodule_memory_size(module), SEG_FINAL);
 
 	return 0;

src/lib/selfboot.c

@@ -452,7 +452,7 @@ static int load_self_segments(
 			 * Each architecture can perform additonal operations
 			 * on the loaded segment
 			 */
-			arch_segment_loaded((uintptr_t)dest, ptr->s_memsz,
+			prog_segment_loaded((uintptr_t)dest, ptr->s_memsz,
 					last_non_empty == ptr ? SEG_FINAL : 0);
 		}
 	}