2 # Enable automatic program execution by the kernel.
4 qemu_target_list="i386 i486 alpha arm armeb sparc32plus ppc ppc64 ppc64le m68k \
5 mips mipsel mipsn32 mipsn32el mips64 mips64el \
6 sh4 sh4eb s390x aarch64 aarch64_be hppa riscv32 riscv64 xtensa xtensaeb \
7 microblaze microblazeel or1k"
9 i386_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x03\x00'
10 i386_mask='\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
13 i486_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x06\x00'
14 i486_mask='\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
17 alpha_magic='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x26\x90'
18 alpha_mask='\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
21 arm_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x28\x00'
22 arm_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
25 armeb_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x28'
26 armeb_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
29 sparc_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x02'
30 sparc_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
33 sparc32plus_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x12'
34 sparc32plus_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
35 sparc32plus_family=sparc
37 ppc_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x14'
38 ppc_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
41 ppc64_magic='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x15'
42 ppc64_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
45 ppc64le_magic='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x15\x00'
46 ppc64le_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\x00'
49 m68k_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x04'
50 m68k_mask='\xff\xff\xff\xff\xff\xff\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
53 # FIXME: We could use the other endianness on a MIPS host.
55 mips_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
56 mips_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
59 mipsel_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
60 mipsel_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
63 mipsn32_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
64 mipsn32_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
67 mipsn32el_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
68 mipsn32el_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
71 mips64_magic='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
72 mips64_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
75 mips64el_magic='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
76 mips64el_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
79 sh4_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2a\x00'
80 sh4_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
83 sh4eb_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2a'
84 sh4eb_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
87 s390x_magic='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x16'
88 s390x_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
91 aarch64_magic='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7\x00'
92 aarch64_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
95 aarch64_be_magic='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7'
96 aarch64_be_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
97 aarch64_be_family=armeb
99 hppa_magic='\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x0f'
100 hppa_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
103 riscv32_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00'
104 riscv32_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
107 riscv64_magic='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00'
108 riscv64_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
111 xtensa_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5e\x00'
112 xtensa_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
115 xtensaeb_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5e'
116 xtensaeb_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
117 xtensaeb_family=xtensaeb
119 microblaze_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xba\xab'
120 microblaze_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
121 microblaze_family=microblaze
123 microblazeel_magic='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xab\xba'
124 microblazeel_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
125 microblazeel_family=microblazeel
127 or1k_magic='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5c'
128 or1k_mask='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
132 cpu=${HOST_ARCH:-$(uname -m)}
134 amd64|i386|i486|i586|i686|i86pc|BePC|x86_64)
140 "Power Macintosh"|ppc64|powerpc|ppc)
146 arm|armel|armhf|arm64|armv[4-9]*l|aarch64)
149 armeb|armv[4-9]*b|aarch64_be)
166 Usage: qemu-binfmt-conf.sh [--qemu-path PATH][--debian][--systemd CPU]
167 [--help][--credential yes|no][--exportdir PATH]
169 Configure binfmt_misc to use qemu interpreter
171 --help: display this usage
172 --qemu-path: set path to qemu interpreter ($QEMU_PATH)
173 --debian: don't write into /proc,
174 instead generate update-binfmts templates
175 --systemd: don't write into /proc,
176 instead generate file for systemd-binfmt.service
177 for the given CPU. If CPU is "ALL", generate a
178 file for all known cpus
179 --exportdir: define where to write configuration files
180 (default: $SYSTEMDDIR or $DEBIANDIR)
181 --credential: if yes, credential and security tokens are
182 calculated according to the binary to interpret
184 To import templates with update-binfmts, use :
186 sudo update-binfmts --importdir ${EXPORTDIR:-$DEBIANDIR} --import qemu-CPU
188 To remove interpreter, use :
190 sudo update-binfmts --package qemu-CPU --remove qemu-CPU $QEMU_PATH
192 With systemd, binfmt files are loaded by systemd-binfmt.service
194 The environment variable HOST_ARCH allows to override 'uname' to generate
195 configuration files for a different architecture than the current one.
204 qemu_check_access() {
205 if [ ! -w "$1" ] ; then
206 echo "ERROR: cannot write to $1" 1>&2
211 qemu_check_bintfmt_misc() {
212 # load the binfmt_misc module
213 if [ ! -d /proc/sys/fs/binfmt_misc ]; then
214 if ! /sbin/modprobe binfmt_misc ; then
218 if [ ! -f /proc/sys/fs/binfmt_misc/register ]; then
219 if ! mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc ; then
224 qemu_check_access /proc/sys/fs/binfmt_misc/register
228 dpkg --status "$1" > /dev/null 2>&1
231 qemu_check_debian() {
232 if [ ! -e /etc/debian_version ] ; then
233 echo "WARNING: your system is not a Debian based distro" 1>&2
234 elif ! installed_dpkg binfmt-support ; then
235 echo "WARNING: package binfmt-support is needed" 1>&2
237 qemu_check_access "$EXPORTDIR"
240 qemu_check_systemd() {
241 if ! systemctl -q is-enabled systemd-binfmt.service ; then
242 echo "WARNING: systemd-binfmt.service is missing or disabled" 1>&2
244 qemu_check_access "$EXPORTDIR"
247 qemu_generate_register() {
248 echo ":qemu-$cpu:M::$magic:$mask:$qemu:$FLAGS"
251 qemu_register_interpreter() {
252 echo "Setting $qemu as binfmt interpreter for $cpu"
253 qemu_generate_register > /proc/sys/fs/binfmt_misc/register
256 qemu_generate_systemd() {
257 echo "Setting $qemu as binfmt interpreter for $cpu for systemd-binfmt.service"
258 qemu_generate_register > "$EXPORTDIR/qemu-$cpu.conf"
261 qemu_generate_debian() {
262 cat > "$EXPORTDIR/qemu-$cpu" <<EOF
268 if [ "$FLAGS" = "OC" ] ; then
269 echo "credentials yes" >> "$EXPORTDIR/qemu-$cpu"
275 host_family=$(qemu_get_family)
277 # register the interpreter for each cpu except for the native one
279 for cpu in ${qemu_target_list} ; do
280 magic=$(eval echo \$${cpu}_magic)
281 mask=$(eval echo \$${cpu}_mask)
282 family=$(eval echo \$${cpu}_family)
284 if [ "$magic" = "" ] || [ "$mask" = "" ] || [ "$family" = "" ] ; then
285 echo "INTERNAL ERROR: unknown cpu $cpu" 1>&2
289 qemu="$QEMU_PATH/qemu-$cpu"
290 if [ "$cpu" = "i486" ] ; then
291 qemu="$QEMU_PATH/qemu-i386"
294 if [ "$host_family" != "$family" ] ; then
300 CHECK=qemu_check_bintfmt_misc
301 BINFMT_SET=qemu_register_interpreter
303 SYSTEMDDIR="/etc/binfmt.d"
304 DEBIANDIR="/usr/share/binfmts"
306 QEMU_PATH=/usr/local/bin
309 options=$(getopt -o ds:Q:e:hc: -l debian,systemd:,qemu-path:,exportdir:,help,credential: -- "$@")
310 eval set -- "$options"
315 CHECK=qemu_check_debian
316 BINFMT_SET=qemu_generate_debian
317 EXPORTDIR=${EXPORTDIR:-$DEBIANDIR}
320 CHECK=qemu_check_systemd
321 BINFMT_SET=qemu_generate_systemd
322 EXPORTDIR=${EXPORTDIR:-$SYSTEMDDIR}
324 # check given cpu is in the supported CPU list
325 if [ "$1" != "ALL" ] ; then
326 for cpu in ${qemu_target_list} ; do
327 if [ "$cpu" = "$1" ] ; then
332 if [ "$cpu" = "$1" ] ; then
333 qemu_target_list="$1"
335 echo "ERROR: unknown CPU \"$1\"" 1>&2
355 if [ "$1" = "yes" ] ; then