xref: /linux-6.15/arch/powerpc/boot/wrapper (revision 331aa46a) 
1#!/bin/sh
2# SPDX-License-Identifier: GPL-2.0-only
3
4# Copyright (C) 2006 Paul Mackerras, IBM Corporation <[email protected]>
5
6# This script takes a kernel binary and optionally an initrd image
7# and/or a device-tree blob, and creates a bootable zImage for a
8# given platform.
9
10# Options:
11# -o zImage	specify output file
12# -p platform	specify platform (links in $platform.o)
13# -i initrd	specify initrd file
14# -d devtree	specify device-tree blob
15# -s tree.dts	specify device-tree source file (needs dtc installed)
16# -e esm_blob   specify ESM blob for secure images
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)
25
26# Stop execution if any command fails
27set -e
28
29# Allow for verbose output
30if [ "$V" = 1 ]; then
31    set -x
32    map="-Map wrapper.map"
33fi
34
35# defaults
36kernel=
37ofile=zImage
38platform=of
39initrd=
40dtb=
41dts=
42esm_blob=
43cacheit=
44binary=
45compression=.gz
46uboot_comp=gzip
47pie=
48format=
49
50# cross-compilation prefix
51CROSS=
52
53# mkimage wrapper script
54MKIMAGE=$srctree/scripts/mkuboot.sh
55
56# directory for object and other files used by this script
57object=arch/powerpc/boot
58objbin=$object
59dtc=scripts/dtc/dtc
60
61# directory for working files
62tmpdir=.
63
64usage() {
65    echo 'Usage: wrapper [-o output] [-p platform] [-i initrd]' >&2
66    echo '       [-d devtree] [-s tree.dts] [-e esm_blob]' >&2
67    echo '       [-c] [-C cross-prefix] [-D datadir] [-W workingdir]' >&2
68    echo '       [-Z (gz|xz|none)] [--no-compression] [vmlinux]' >&2
69    exit 1
70}
71
72run_cmd() {
73    if [ "$V" = 1 ]; then
74        $* 2>&1
75    else
76        local msg
77
78        set +e
79        msg=$($* 2>&1)
80
81        if [ $? -ne "0" ]; then
82                echo $msg
83                exit 1
84        fi
85        set -e
86    fi
87}
88
89while [ "$#" -gt 0 ]; do
90    case "$1" in
91    -o)
92	shift
93	[ "$#" -gt 0 ] || usage
94	ofile="$1"
95	;;
96    -p)
97	shift
98	[ "$#" -gt 0 ] || usage
99	platform="$1"
100	;;
101    -i)
102	shift
103	[ "$#" -gt 0 ] || usage
104	initrd="$1"
105	;;
106    -d)
107	shift
108	[ "$#" -gt 0 ] || usage
109	dtb="$1"
110	;;
111    -e)
112	shift
113	[ "$#" -gt 0 ] || usage
114	esm_blob="$1"
115	;;
116    -s)
117	shift
118	[ "$#" -gt 0 ] || usage
119	dts="$1"
120	;;
121    -c)
122	cacheit=y
123	;;
124    -C)
125	shift
126	[ "$#" -gt 0 ] || usage
127	CROSS="$1"
128	;;
129    -D)
130	shift
131	[ "$#" -gt 0 ] || usage
132	object="$1"
133	objbin="$1"
134	;;
135    -W)
136	shift
137	[ "$#" -gt 0 ] || usage
138	tmpdir="$1"
139	;;
140    -z)
141	compression=.gz
142	uboot_comp=gzip
143	;;
144    -Z)
145	shift
146	[ "$#" -gt 0 ] || usage
147        [ "$1" != "gz" -o "$1" != "xz" -o "$1" != "lzma" -o "$1" != "lzo" -o "$1" != "none" ] || usage
148
149	compression=".$1"
150	uboot_comp=$1
151
152        if [ $compression = ".none" ]; then
153                compression=
154		uboot_comp=none
155        fi
156	if [ $uboot_comp = "gz" ]; then
157		uboot_comp=gzip
158	fi
159	;;
160    --no-gzip)
161        # a "feature" of the the wrapper script is that it can be used outside
162        # the kernel tree. So keeping this around for backwards compatibility.
163        compression=
164	uboot_comp=none
165        ;;
166    -?)
167	usage
168	;;
169    *)
170	[ -z "$kernel" ] || usage
171	kernel="$1"
172	;;
173    esac
174    shift
175done
176
177
178if [ -n "$dts" ]; then
179    if [ ! -r "$dts" -a -r "$object/dts/$dts" ]; then
180	dts="$object/dts/$dts"
181    fi
182    if [ -z "$dtb" ]; then
183	dtb="$platform.dtb"
184    fi
185    $dtc -O dtb -o "$dtb" -b 0 "$dts"
186fi
187
188if [ -z "$kernel" ]; then
189    kernel=vmlinux
190fi
191
192LANG=C elfformat="`${CROSS}objdump -p "$kernel" | grep 'file format' | awk '{print $4}'`"
193case "$elfformat" in
194    elf64-powerpcle)	format=elf64lppc	;;
195    elf64-powerpc)	format=elf32ppc	;;
196    elf32-powerpc)	format=elf32ppc	;;
197esac
198
199ld_version()
200{
201    # Poached from scripts/ld-version.sh, but we don't want to call that because
202    # this script (wrapper) is distributed separately from the kernel source.
203    # Extract linker version number from stdin and turn into single number.
204    awk '{
205	gsub(".*\\)", "");
206	gsub(".*version ", "");
207	gsub("-.*", "");
208	split($1,a, ".");
209	print a[1]*100000000 + a[2]*1000000 + a[3]*10000;
210	exit
211    }'
212}
213
214# Do not include PT_INTERP segment when linking pie. Non-pie linking
215# just ignores this option.
216LD_VERSION=$(${CROSS}ld --version | ld_version)
217LD_NO_DL_MIN_VERSION=$(echo 2.26 | ld_version)
218if [ "$LD_VERSION" -ge "$LD_NO_DL_MIN_VERSION" ] ; then
219	nodl="--no-dynamic-linker"
220fi
221
222platformo=$object/"$platform".o
223lds=$object/zImage.lds
224ext=strip
225objflags=-S
226tmp=$tmpdir/zImage.$$.o
227ksection=.kernel:vmlinux.strip
228isection=.kernel:initrd
229esection=.kernel:esm_blob
230link_address='0x400000'
231make_space=y
232
233
234if [ -n "$esm_blob" -a "$platform" != "pseries" ]; then
235    echo "ESM blob not support on non-pseries platforms" >&2
236    exit 1
237fi
238
239case "$platform" in
240of)
241    platformo="$object/of.o $object/epapr.o"
242    make_space=n
243    ;;
244pseries)
245    platformo="$object/pseries-head.o $object/of.o $object/epapr.o"
246    link_address='0x4000000'
247    if [ "$format" != "elf32ppc" ]; then
248	link_address=
249	pie=-pie
250    fi
251    make_space=n
252    ;;
253maple)
254    platformo="$object/of.o $object/epapr.o"
255    link_address='0x400000'
256    make_space=n
257    ;;
258pmac|chrp)
259    platformo="$object/of.o $object/epapr.o"
260    make_space=n
261    ;;
262coff)
263    platformo="$object/crt0.o $object/of.o $object/epapr.o"
264    lds=$object/zImage.coff.lds
265    link_address='0x500000'
266    make_space=n
267    pie=
268    ;;
269miboot|uboot*)
270    # miboot and U-boot want just the bare bits, not an ELF binary
271    ext=bin
272    objflags="-O binary"
273    tmp="$ofile"
274    ksection=image
275    isection=initrd
276    ;;
277cuboot*)
278    binary=y
279    compression=
280    case "$platform" in
281    *-mpc866ads|*-mpc885ads|*-adder875*|*-ep88xc)
282        platformo=$object/cuboot-8xx.o
283        ;;
284    *5200*|*-motionpro)
285        platformo=$object/cuboot-52xx.o
286        ;;
287    *-pq2fads|*-ep8248e|*-mpc8272*|*-storcenter)
288        platformo=$object/cuboot-pq2.o
289        ;;
290    *-mpc824*)
291        platformo=$object/cuboot-824x.o
292        ;;
293    *-mpc83*|*-asp834x*)
294        platformo=$object/cuboot-83xx.o
295        ;;
296    *-tqm8541|*-mpc8560*|*-tqm8560|*-tqm8555|*-ksi8560*)
297        platformo=$object/cuboot-85xx-cpm2.o
298        ;;
299    *-mpc85*|*-tqm85*|*-sbc85*)
300        platformo=$object/cuboot-85xx.o
301        ;;
302    *-amigaone)
303        link_address='0x800000'
304        ;;
305    esac
306    ;;
307ps3)
308    platformo="$object/ps3-head.o $object/ps3-hvcall.o $object/ps3.o"
309    lds=$object/zImage.ps3.lds
310    compression=
311    ext=bin
312    objflags="-O binary --set-section-flags=.bss=contents,alloc,load,data"
313    ksection=.kernel:vmlinux.bin
314    isection=.kernel:initrd
315    link_address=''
316    make_space=n
317    pie=
318    ;;
319ep88xc|ep405|ep8248e)
320    platformo="$object/fixed-head.o $object/$platform.o"
321    binary=y
322    ;;
323adder875-redboot)
324    platformo="$object/fixed-head.o $object/redboot-8xx.o"
325    binary=y
326    ;;
327simpleboot-virtex405-*)
328    platformo="$object/virtex405-head.o $object/simpleboot.o $object/virtex.o"
329    binary=y
330    ;;
331simpleboot-virtex440-*)
332    platformo="$object/fixed-head.o $object/simpleboot.o $object/virtex.o"
333    binary=y
334    ;;
335simpleboot-*)
336    platformo="$object/fixed-head.o $object/simpleboot.o"
337    binary=y
338    ;;
339asp834x-redboot)
340    platformo="$object/fixed-head.o $object/redboot-83xx.o"
341    binary=y
342    ;;
343xpedite52*)
344    link_address='0x1400000'
345    platformo=$object/cuboot-85xx.o
346    ;;
347gamecube|wii)
348    link_address='0x600000'
349    platformo="$object/$platform-head.o $object/$platform.o"
350    ;;
351treeboot-currituck)
352    link_address='0x1000000'
353    ;;
354treeboot-akebono)
355    link_address='0x1000000'
356    ;;
357treeboot-iss4xx-mpic)
358    platformo="$object/treeboot-iss4xx.o"
359    ;;
360epapr)
361    platformo="$object/pseries-head.o $object/epapr.o $object/epapr-wrapper.o"
362    link_address='0x20000000'
363    pie=-pie
364    ;;
365mvme5100)
366    platformo="$object/fixed-head.o $object/mvme5100.o"
367    binary=y
368    ;;
369mvme7100)
370    platformo="$object/motload-head.o $object/mvme7100.o"
371    link_address='0x4000000'
372    binary=y
373    ;;
374esac
375
376vmz="$tmpdir/`basename \"$kernel\"`.$ext"
377
378# Calculate the vmlinux.strip size
379${CROSS}objcopy $objflags "$kernel" "$vmz.$$"
380strip_size=$(${CONFIG_SHELL} "${srctree}/scripts/file-size.sh" "$vmz.$$")
381
382if [ -z "$cacheit" -o ! -f "$vmz$compression" -o "$vmz$compression" -ot "$kernel" ]; then
383    # recompress the image if we need to
384    case $compression in
385    .xz)
386        xz --check=crc32 -f -6 "$vmz.$$"
387        ;;
388    .gz)
389        gzip -n -f -9 "$vmz.$$"
390        ;;
391    .lzma)
392        xz --format=lzma -f -6 "$vmz.$$"
393	;;
394    .lzo)
395        lzop -f -9 "$vmz.$$"
396	;;
397    *)
398        # drop the compression suffix so the stripped vmlinux is used
399        compression=
400	uboot_comp=none
401	;;
402    esac
403
404    if [ -n "$cacheit" ]; then
405	mv -f "$vmz.$$$compression" "$vmz$compression"
406    else
407	vmz="$vmz.$$"
408    fi
409else
410    rm -f $vmz.$$
411fi
412
413vmz="$vmz$compression"
414
415if [ "$make_space" = "y" ]; then
416	# Round the size to next higher MB limit
417	round_size=$(((strip_size + 0xfffff) & 0xfff00000))
418
419	round_size=0x$(printf "%x" $round_size)
420	link_addr=$(printf "%d" $link_address)
421
422	if [ $link_addr -lt $strip_size ]; then
423	    echo "INFO: Uncompressed kernel (size 0x$(printf "%x\n" $strip_size))" \
424			"overlaps the address of the wrapper($link_address)"
425	    echo "INFO: Fixing the link_address of wrapper to ($round_size)"
426	    link_address=$round_size
427	fi
428fi
429
430# Extract kernel version information, some platforms want to include
431# it in the image header
432version=`${CROSS}strings "$kernel" | grep '^Linux version [-0-9.]' | \
433    cut -d' ' -f3`
434if [ -n "$version" ]; then
435    uboot_version="-n Linux-$version"
436fi
437
438# physical offset of kernel image
439membase=`${CROSS}objdump -p "$kernel" | grep -m 1 LOAD | awk '{print $7}'`
440
441case "$platform" in
442uboot)
443    rm -f "$ofile"
444    ${MKIMAGE} -A ppc -O linux -T kernel -C $uboot_comp -a $membase -e $membase \
445	$uboot_version -d "$vmz" "$ofile"
446    if [ -z "$cacheit" ]; then
447	rm -f "$vmz"
448    fi
449    exit 0
450    ;;
451uboot-obs600)
452    rm -f "$ofile"
453    # obs600 wants a multi image with an initrd, so we need to put a fake
454    # one in even when building a "normal" image.
455    if [ -n "$initrd" ]; then
456	real_rd="$initrd"
457    else
458	real_rd=`mktemp`
459	echo "\0" >>"$real_rd"
460    fi
461    ${MKIMAGE} -A ppc -O linux -T multi -C gzip -a $membase -e $membase \
462	$uboot_version -d "$vmz":"$real_rd":"$dtb" "$ofile"
463    if [ -z "$initrd" ]; then
464	rm -f "$real_rd"
465    fi
466    if [ -z "$cacheit" ]; then
467	rm -f "$vmz"
468    fi
469    exit 0
470    ;;
471esac
472
473addsec() {
474    ${CROSS}objcopy $4 $1 \
475	--add-section=$3="$2" \
476	--set-section-flags=$3=contents,alloc,load,readonly,data
477}
478
479addsec $tmp "$vmz" $ksection $object/empty.o
480if [ -z "$cacheit" ]; then
481    rm -f "$vmz"
482fi
483
484if [ -n "$initrd" ]; then
485    addsec $tmp "$initrd" $isection
486fi
487
488if [ -n "$dtb" ]; then
489    addsec $tmp "$dtb" .kernel:dtb
490    if [ -n "$dts" ]; then
491	rm $dtb
492    fi
493fi
494
495if [ -n "$esm_blob" ]; then
496    addsec $tmp "$esm_blob" $esection
497fi
498
499if [ "$platform" != "miboot" ]; then
500    if [ -n "$link_address" ] ; then
501        text_start="-Ttext $link_address"
502    fi
503#link everything
504    ${CROSS}ld -m $format -T $lds $text_start $pie $nodl -o "$ofile" $map \
505	$platformo $tmp $object/wrapper.a
506    rm $tmp
507fi
508
509# Some platforms need the zImage's entry point and base address
510base=0x`${CROSS}nm "$ofile" | grep ' _start$' | cut -d' ' -f1`
511entry=`${CROSS}objdump -f "$ofile" | grep '^start address ' | cut -d' ' -f3`
512
513if [ -n "$binary" ]; then
514    mv "$ofile" "$ofile".elf
515    ${CROSS}objcopy -O binary "$ofile".elf "$ofile"
516fi
517
518# post-processing needed for some platforms
519case "$platform" in
520pseries|chrp|maple)
521    $objbin/addnote "$ofile"
522    ;;
523coff)
524    ${CROSS}objcopy -O aixcoff-rs6000 --set-start "$entry" "$ofile"
525    $objbin/hack-coff "$ofile"
526    ;;
527cuboot*)
528    gzip -n -f -9 "$ofile"
529    ${MKIMAGE} -A ppc -O linux -T kernel -C gzip -a "$base" -e "$entry" \
530            $uboot_version -d "$ofile".gz "$ofile"
531    ;;
532treeboot*)
533    mv "$ofile" "$ofile.elf"
534    $objbin/mktree "$ofile.elf" "$ofile" "$base" "$entry"
535    if [ -z "$cacheit" ]; then
536	rm -f "$ofile.elf"
537    fi
538    exit 0
539    ;;
540ps3)
541    # The ps3's loader supports loading a gzipped binary image from flash
542    # rom to ram addr zero. The loader then enters the system reset
543    # vector at addr 0x100.  A bootwrapper overlay is used to arrange for
544    # a binary image of the kernel to be at addr zero, and yet have a
545    # suitable bootwrapper entry at 0x100.  To construct the final rom
546    # image 512 bytes from offset 0x100 is copied to the bootwrapper
547    # place holder at symbol __system_reset_kernel.  The 512 bytes of the
548    # bootwrapper entry code at symbol __system_reset_overlay is then
549    # copied to offset 0x100.  At runtime the bootwrapper program copies
550    # the data at __system_reset_kernel back to addr 0x100.
551
552    system_reset_overlay=0x`${CROSS}nm "$ofile" \
553        | grep ' __system_reset_overlay$'       \
554        | cut -d' ' -f1`
555    system_reset_overlay=`printf "%d" $system_reset_overlay`
556    system_reset_kernel=0x`${CROSS}nm "$ofile" \
557        | grep ' __system_reset_kernel$'       \
558        | cut -d' ' -f1`
559    system_reset_kernel=`printf "%d" $system_reset_kernel`
560    overlay_dest="256"
561    overlay_size="512"
562
563    ${CROSS}objcopy -O binary "$ofile" "$ofile.bin"
564
565    run_cmd dd if="$ofile.bin" of="$ofile.bin" conv=notrunc   \
566        skip=$overlay_dest seek=$system_reset_kernel          \
567        count=$overlay_size bs=1
568
569    run_cmd dd if="$ofile.bin" of="$ofile.bin" conv=notrunc   \
570        skip=$system_reset_overlay seek=$overlay_dest         \
571        count=$overlay_size bs=1
572
573    odir="$(dirname "$ofile.bin")"
574    rm -f "$odir/otheros.bld"
575    gzip -n --force -9 --stdout "$ofile.bin" > "$odir/otheros.bld"
576    ;;
577esac
578