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 x86_64"
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 x86_64_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00'
18 x86_64_mask
='\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
21 alpha_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x26\x90'
22 alpha_mask
='\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
25 arm_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x28\x00'
26 arm_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
29 armeb_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x28'
30 armeb_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
33 sparc_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x02'
34 sparc_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
37 sparc32plus_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x12'
38 sparc32plus_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
39 sparc32plus_family
=sparc
41 ppc_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x14'
42 ppc_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
45 ppc64_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x15'
46 ppc64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
49 ppc64le_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x15\x00'
50 ppc64le_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\x00'
53 m68k_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x04'
54 m68k_mask
='\xff\xff\xff\xff\xff\xff\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
57 # FIXME: We could use the other endianness on a MIPS host.
59 mips_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
60 mips_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
63 mipsel_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
64 mipsel_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
67 mipsn32_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
68 mipsn32_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
71 mipsn32el_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
72 mipsn32el_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
75 mips64_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
76 mips64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
79 mips64el_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
80 mips64el_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
83 sh4_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2a\x00'
84 sh4_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
87 sh4eb_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2a'
88 sh4eb_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
91 s390x_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x16'
92 s390x_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
95 aarch64_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7\x00'
96 aarch64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
99 aarch64_be_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7'
100 aarch64_be_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
101 aarch64_be_family
=armeb
103 hppa_magic
='\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x0f'
104 hppa_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
107 riscv32_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00'
108 riscv32_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
111 riscv64_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00'
112 riscv64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
115 xtensa_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5e\x00'
116 xtensa_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
119 xtensaeb_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5e'
120 xtensaeb_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
121 xtensaeb_family
=xtensaeb
123 microblaze_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xba\xab'
124 microblaze_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
125 microblaze_family
=microblaze
127 microblazeel_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xab\xba'
128 microblazeel_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
129 microblazeel_family
=microblazeel
131 or1k_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5c'
132 or1k_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
136 cpu
=${HOST_ARCH:-$(uname -m)}
138 amd64|i386|i486|i586|i686|i86pc|BePC|x86_64
)
144 "Power Macintosh"|ppc64|powerpc|ppc
)
150 arm|armel|armhf|arm64|armv
[4-9]*l|aarch64
)
153 armeb|armv
[4-9]*b|aarch64_be
)
170 Usage: qemu-binfmt-conf.sh [--qemu-path PATH][--debian][--systemd CPU]
171 [--help][--credential yes|no][--exportdir PATH]
172 [--persistent yes|no][--qemu-suffix SUFFIX]
174 Configure binfmt_misc to use qemu interpreter
176 --help: display this usage
177 --qemu-path: set path to qemu interpreter ($QEMU_PATH)
178 --qemu-suffix: add a suffix to the default interpreter name
179 --debian: don't write into /proc,
180 instead generate update-binfmts templates
181 --systemd: don't write into /proc,
182 instead generate file for systemd-binfmt.service
183 for the given CPU. If CPU is "ALL", generate a
184 file for all known cpus
185 --exportdir: define where to write configuration files
186 (default: $SYSTEMDDIR or $DEBIANDIR)
187 --credential: if yes, credential and security tokens are
188 calculated according to the binary to interpret
189 --persistent: if yes, the interpreter is loaded when binfmt is
190 configured and remains in memory. All future uses
191 are cloned from the open file.
193 To import templates with update-binfmts, use :
195 sudo update-binfmts --importdir ${EXPORTDIR:-$DEBIANDIR} --import qemu-CPU
197 To remove interpreter, use :
199 sudo update-binfmts --package qemu-CPU --remove qemu-CPU $QEMU_PATH
201 With systemd, binfmt files are loaded by systemd-binfmt.service
203 The environment variable HOST_ARCH allows to override 'uname' to generate
204 configuration files for a different architecture than the current one.
213 qemu_check_access
() {
214 if [ ! -w "$1" ] ; then
215 echo "ERROR: cannot write to $1" 1>&2
220 qemu_check_bintfmt_misc
() {
221 # load the binfmt_misc module
222 if [ ! -d /proc
/sys
/fs
/binfmt_misc
]; then
223 if ! /sbin
/modprobe binfmt_misc
; then
227 if [ ! -f /proc
/sys
/fs
/binfmt_misc
/register
]; then
228 if ! mount binfmt_misc
-t binfmt_misc
/proc
/sys
/fs
/binfmt_misc
; then
233 qemu_check_access
/proc
/sys
/fs
/binfmt_misc
/register
237 dpkg
--status "$1" > /dev
/null
2>&1
240 qemu_check_debian
() {
241 if [ ! -e /etc
/debian_version
] ; then
242 echo "WARNING: your system is not a Debian based distro" 1>&2
243 elif ! installed_dpkg binfmt-support
; then
244 echo "WARNING: package binfmt-support is needed" 1>&2
246 qemu_check_access
"$EXPORTDIR"
249 qemu_check_systemd
() {
250 if ! systemctl
-q is-enabled systemd-binfmt.service
; then
251 echo "WARNING: systemd-binfmt.service is missing or disabled" 1>&2
253 qemu_check_access
"$EXPORTDIR"
256 qemu_generate_register
() {
258 if [ "$CREDENTIAL" = "yes" ] ; then
261 if [ "$PERSISTENT" = "yes" ] ; then
265 echo ":qemu-$cpu:M::$magic:$mask:$qemu:$flags"
268 qemu_register_interpreter
() {
269 echo "Setting $qemu as binfmt interpreter for $cpu"
270 qemu_generate_register
> /proc
/sys
/fs
/binfmt_misc
/register
273 qemu_generate_systemd
() {
274 echo "Setting $qemu as binfmt interpreter for $cpu for systemd-binfmt.service"
275 qemu_generate_register
> "$EXPORTDIR/qemu-$cpu.conf"
278 qemu_generate_debian
() {
279 cat > "$EXPORTDIR/qemu-$cpu" <<EOF
284 credential $CREDENTIAL
290 host_family
=$
(qemu_get_family
)
292 # register the interpreter for each cpu except for the native one
294 for cpu
in ${qemu_target_list} ; do
295 magic
=$
(eval echo \$
${cpu}_magic
)
296 mask
=$
(eval echo \$
${cpu}_mask
)
297 family
=$
(eval echo \$
${cpu}_family
)
299 if [ "$magic" = "" ] ||
[ "$mask" = "" ] ||
[ "$family" = "" ] ; then
300 echo "INTERNAL ERROR: unknown cpu $cpu" 1>&2
304 qemu
="$QEMU_PATH/qemu-$cpu"
305 if [ "$cpu" = "i486" ] ; then
306 qemu
="$QEMU_PATH/qemu-i386"
309 qemu
="$qemu$QEMU_SUFFIX"
310 if [ "$host_family" != "$family" ] ; then
316 CHECK
=qemu_check_bintfmt_misc
317 BINFMT_SET
=qemu_register_interpreter
319 SYSTEMDDIR
="/etc/binfmt.d"
320 DEBIANDIR
="/usr/share/binfmts"
322 QEMU_PATH
=/usr
/local
/bin
327 options
=$
(getopt
-o ds
:Q
:S
:e
:hc
:p
: -l debian
,systemd
:,qemu-path
:,qemu-suffix
:,exportdir
:,help,credential
:,persistent
: -- "$@")
328 eval set -- "$options"
333 CHECK
=qemu_check_debian
334 BINFMT_SET
=qemu_generate_debian
335 EXPORTDIR
=${EXPORTDIR:-$DEBIANDIR}
338 CHECK
=qemu_check_systemd
339 BINFMT_SET
=qemu_generate_systemd
340 EXPORTDIR
=${EXPORTDIR:-$SYSTEMDDIR}
342 # check given cpu is in the supported CPU list
343 if [ "$1" != "ALL" ] ; then
344 for cpu
in ${qemu_target_list} ; do
345 if [ "$cpu" = "$1" ] ; then
350 if [ "$cpu" = "$1" ] ; then
351 qemu_target_list
="$1"
353 echo "ERROR: unknown CPU \"$1\"" 1>&2