3 # Copyright (C) 2006 Paul Mackerras, IBM Corporation <paulus@samba.org>
4 # This program may be used under the terms of version 2 of the GNU
5 # General Public License.
7 # This script takes a kernel binary and optionally an initrd image
8 # and/or a device-tree blob, and creates a bootable zImage for a
12 # -o zImage specify output file
13 # -p platform specify platform (links in $platform.o)
14 # -i initrd specify initrd file
15 # -d devtree specify device-tree blob
16 # -s tree.dts specify device-tree source file (needs dtc installed)
17 # -c cache $kernel.strip.gz (use if present & newer, else make)
18 # -C prefix specify command prefix for cross-building tools
19 # (strip, objcopy, ld)
20 # -D dir specify directory containing data files used by script
21 # (default ./arch/powerpc/boot)
22 # -W dir specify working directory for temporary files (default .)
23 # -z use gzip (legacy)
24 # -Z zsuffix compression to use (gz, xz or none)
26 # Stop execution if any command fails
29 # Allow for verbose output
47 # cross-compilation prefix
50 # mkimage wrapper script
51 MKIMAGE=$srctree/scripts/mkuboot.sh
53 # directory for object and other files used by this script
54 object=arch/powerpc/boot
58 # directory for working files
62 echo 'Usage: wrapper [-o output] [-p platform] [-i initrd]' >&2
63 echo ' [-d devtree] [-s tree.dts] [-c] [-C cross-prefix]' >&2
64 echo ' [-D datadir] [-W workingdir] [-Z (gz|xz|none)]' >&2
65 echo ' [--no-compression] [vmlinux]' >&2
78 if [ $? -ne "0" ]; then
86 while [ "$#" -gt 0 ]; do
90 [ "$#" -gt 0 ] || usage
95 [ "$#" -gt 0 ] || usage
100 [ "$#" -gt 0 ] || usage
105 [ "$#" -gt 0 ] || usage
110 [ "$#" -gt 0 ] || usage
118 [ "$#" -gt 0 ] || usage
123 [ "$#" -gt 0 ] || usage
129 [ "$#" -gt 0 ] || usage
137 [ "$#" -gt 0 ] || usage
138 [ "$1" != "gz" -o "$1" != "xz" -o "$1" != "none" ] || usage
142 if [ $compression = ".none" ]; then
147 # a "feature" of the the wrapper script is that it can be used outside
148 # the kernel tree. So keeping this around for backwards compatibility.
155 [ -z "$kernel" ] || usage
163 if [ -n "$dts" ]; then
164 if [ ! -r "$dts" -a -r "$object/dts/$dts" ]; then
165 dts="$object/dts/$dts"
167 if [ -z "$dtb" ]; then
170 $dtc -O dtb -o "$dtb" -b 0 "$dts"
173 if [ -z "$kernel" ]; then
177 LANG=C elfformat="`${CROSS}objdump -p "$kernel" | grep 'file format' | awk '{print $4}'`"
179 elf64-powerpcle) format=elf64lppc ;;
180 elf64-powerpc) format=elf32ppc ;;
181 elf32-powerpc) format=elf32ppc ;;
186 # Poached from scripts/ld-version.sh, but we don't want to call that because
187 # this script (wrapper) is distributed separately from the kernel source.
188 # Extract linker version number from stdin and turn into single number.
191 gsub(".*version ", "");
194 print a[1]*100000000 + a[2]*1000000 + a[3]*10000;
199 # Do not include PT_INTERP segment when linking pie. Non-pie linking
200 # just ignores this option.
201 LD_VERSION=$(${CROSS}ld --version | ld_version)
202 LD_NO_DL_MIN_VERSION=$(echo 2.26 | ld_version)
203 if [ "$LD_VERSION" -ge "$LD_NO_DL_MIN_VERSION" ] ; then
204 nodl="--no-dynamic-linker"
207 platformo=$object/"$platform".o
208 lds=$object/zImage.lds
211 tmp=$tmpdir/zImage.$$.o
212 ksection=.kernel:vmlinux.strip
213 isection=.kernel:initrd
214 link_address='0x400000'
219 platformo="$object/of.o $object/epapr.o"
223 platformo="$object/pseries-head.o $object/of.o $object/epapr.o"
224 link_address='0x4000000'
225 if [ "$format" != "elf32ppc" ]; then
232 platformo="$object/of.o $object/epapr.o"
233 link_address='0x400000'
237 platformo="$object/of.o $object/epapr.o"
241 platformo="$object/crt0.o $object/of.o $object/epapr.o"
242 lds=$object/zImage.coff.lds
243 link_address='0x500000'
248 # miboot and U-boot want just the bare bits, not an ELF binary
259 *-mpc866ads|*-mpc885ads|*-adder875*|*-ep88xc)
260 platformo=$object/cuboot-8xx.o
263 platformo=$object/cuboot-52xx.o
265 *-pq2fads|*-ep8248e|*-mpc8272*|*-storcenter)
266 platformo=$object/cuboot-pq2.o
269 platformo=$object/cuboot-824x.o
272 platformo=$object/cuboot-83xx.o
274 *-tqm8541|*-mpc8560*|*-tqm8560|*-tqm8555|*-ksi8560*)
275 platformo=$object/cuboot-85xx-cpm2.o
277 *-mpc85*|*-tqm85*|*-sbc85*)
278 platformo=$object/cuboot-85xx.o
281 link_address='0x800000'
286 platformo="$object/ps3-head.o $object/ps3-hvcall.o $object/ps3.o"
287 lds=$object/zImage.ps3.lds
290 objflags="-O binary --set-section-flags=.bss=contents,alloc,load,data"
291 ksection=.kernel:vmlinux.bin
292 isection=.kernel:initrd
297 ep88xc|ep405|ep8248e)
298 platformo="$object/fixed-head.o $object/$platform.o"
302 platformo="$object/fixed-head.o $object/redboot-8xx.o"
305 simpleboot-virtex405-*)
306 platformo="$object/virtex405-head.o $object/simpleboot.o $object/virtex.o"
309 simpleboot-virtex440-*)
310 platformo="$object/fixed-head.o $object/simpleboot.o $object/virtex.o"
314 platformo="$object/fixed-head.o $object/simpleboot.o"
318 platformo="$object/fixed-head.o $object/redboot-83xx.o"
322 link_address='0x1400000'
323 platformo=$object/cuboot-85xx.o
326 link_address='0x600000'
327 platformo="$object/$platform-head.o $object/$platform.o"
330 link_address='0x1000000'
333 link_address='0x1000000'
335 treeboot-iss4xx-mpic)
336 platformo="$object/treeboot-iss4xx.o"
339 platformo="$object/pseries-head.o $object/epapr.o $object/epapr-wrapper.o"
340 link_address='0x20000000'
344 platformo="$object/fixed-head.o $object/mvme5100.o"
348 platformo="$object/motload-head.o $object/mvme7100.o"
349 link_address='0x4000000'
354 vmz="$tmpdir/`basename \"$kernel\"`.$ext"
356 # Calculate the vmlinux.strip size
357 ${CROSS}objcopy $objflags "$kernel" "$vmz.$$"
358 strip_size=$(stat -c %s $vmz.$$)
360 if [ -z "$cacheit" -o ! -f "$vmz$compression" -o "$vmz$compression" -ot "$kernel" ]; then
361 # recompress the image if we need to
364 xz --check=crc32 -f -6 "$vmz.$$"
367 gzip -n -f -9 "$vmz.$$"
370 # drop the compression suffix so the stripped vmlinux is used
375 if [ -n "$cacheit" ]; then
376 mv -f "$vmz.$$$compression" "$vmz$compression"
384 vmz="$vmz$compression"
386 if [ "$make_space" = "y" ]; then
387 # Round the size to next higher MB limit
388 round_size=$(((strip_size + 0xfffff) & 0xfff00000))
390 round_size=0x$(printf "%x" $round_size)
391 link_addr=$(printf "%d" $link_address)
393 if [ $link_addr -lt $strip_size ]; then
394 echo "INFO: Uncompressed kernel (size 0x$(printf "%x\n" $strip_size))" \
395 "overlaps the address of the wrapper($link_address)"
396 echo "INFO: Fixing the link_address of wrapper to ($round_size)"
397 link_address=$round_size
401 # Extract kernel version information, some platforms want to include
402 # it in the image header
403 version=`${CROSS}strings "$kernel" | grep '^Linux version [-0-9.]' | \
405 if [ -n "$version" ]; then
406 uboot_version="-n Linux-$version"
409 # physical offset of kernel image
410 membase=`${CROSS}objdump -p "$kernel" | grep -m 1 LOAD | awk '{print $7}'`
415 ${MKIMAGE} -A ppc -O linux -T kernel -C gzip -a $membase -e $membase \
416 $uboot_version -d "$vmz" "$ofile"
417 if [ -z "$cacheit" ]; then
424 # obs600 wants a multi image with an initrd, so we need to put a fake
425 # one in even when building a "normal" image.
426 if [ -n "$initrd" ]; then
430 echo "\0" >>"$real_rd"
432 ${MKIMAGE} -A ppc -O linux -T multi -C gzip -a $membase -e $membase \
433 $uboot_version -d "$vmz":"$real_rd":"$dtb" "$ofile"
434 if [ -z "$initrd" ]; then
437 if [ -z "$cacheit" ]; then
445 ${CROSS}objcopy $4 $1 \
446 --add-section=$3="$2" \
447 --set-section-flags=$3=contents,alloc,load,readonly,data
450 addsec $tmp "$vmz" $ksection $object/empty.o
451 if [ -z "$cacheit" ]; then
455 if [ -n "$initrd" ]; then
456 addsec $tmp "$initrd" $isection
459 if [ -n "$dtb" ]; then
460 addsec $tmp "$dtb" .kernel:dtb
461 if [ -n "$dts" ]; then
466 if [ "$platform" != "miboot" ]; then
467 if [ -n "$link_address" ] ; then
468 text_start="-Ttext $link_address"
471 ${CROSS}ld -m $format -T $lds $text_start $pie $nodl -o "$ofile" \
472 $platformo $tmp $object/wrapper.a
476 # Some platforms need the zImage's entry point and base address
477 base=0x`${CROSS}nm "$ofile" | grep ' _start$' | cut -d' ' -f1`
478 entry=`${CROSS}objdump -f "$ofile" | grep '^start address ' | cut -d' ' -f3`
480 if [ -n "$binary" ]; then
481 mv "$ofile" "$ofile".elf
482 ${CROSS}objcopy -O binary "$ofile".elf "$ofile"
485 # post-processing needed for some platforms
488 $objbin/addnote "$ofile"
491 ${CROSS}objcopy -O aixcoff-rs6000 --set-start "$entry" "$ofile"
492 $objbin/hack-coff "$ofile"
495 gzip -n -f -9 "$ofile"
496 ${MKIMAGE} -A ppc -O linux -T kernel -C gzip -a "$base" -e "$entry" \
497 $uboot_version -d "$ofile".gz "$ofile"
500 mv "$ofile" "$ofile.elf"
501 $objbin/mktree "$ofile.elf" "$ofile" "$base" "$entry"
502 if [ -z "$cacheit" ]; then
508 # The ps3's loader supports loading a gzipped binary image from flash
509 # rom to ram addr zero. The loader then enters the system reset
510 # vector at addr 0x100. A bootwrapper overlay is used to arrange for
511 # a binary image of the kernel to be at addr zero, and yet have a
512 # suitable bootwrapper entry at 0x100. To construct the final rom
513 # image 512 bytes from offset 0x100 is copied to the bootwrapper
514 # place holder at symbol __system_reset_kernel. The 512 bytes of the
515 # bootwrapper entry code at symbol __system_reset_overlay is then
516 # copied to offset 0x100. At runtime the bootwrapper program copies
517 # the data at __system_reset_kernel back to addr 0x100.
519 system_reset_overlay=0x`${CROSS}nm "$ofile" \
520 | grep ' __system_reset_overlay$' \
522 system_reset_overlay=`printf "%d" $system_reset_overlay`
523 system_reset_kernel=0x`${CROSS}nm "$ofile" \
524 | grep ' __system_reset_kernel$' \
526 system_reset_kernel=`printf "%d" $system_reset_kernel`
530 ${CROSS}objcopy -O binary "$ofile" "$ofile.bin"
532 run_cmd dd if="$ofile.bin" of="$ofile.bin" conv=notrunc \
533 skip=$overlay_dest seek=$system_reset_kernel \
534 count=$overlay_size bs=1
536 run_cmd dd if="$ofile.bin" of="$ofile.bin" conv=notrunc \
537 skip=$system_reset_overlay seek=$overlay_dest \
538 count=$overlay_size bs=1
540 odir="$(dirname "$ofile.bin")"
541 rm -f "$odir/otheros.bld"
542 gzip -n --force -9 --stdout "$ofile.bin" > "$odir/otheros.bld"