2 # Enable automatic program execution by the kernel.
4 qemu_target_list
="i386 i486 alpha arm armeb sparc sparc32plus sparc64 \
5 ppc ppc64 ppc64le m68k mips mipsel mipsn32 mipsn32el mips64 mips64el \
6 sh4 sh4eb s390x aarch64 aarch64_be hppa riscv32 riscv64 xtensa xtensaeb \
7 microblaze microblazeel or1k x86_64 hexagon loongarch64"
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 sparc64_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2b'
42 sparc64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
45 ppc_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x14'
46 ppc_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
49 ppc64_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x15'
50 ppc64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
53 ppc64le_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x15\x00'
54 ppc64le_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\x00'
57 m68k_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x04'
58 m68k_mask
='\xff\xff\xff\xff\xff\xff\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
61 # FIXME: We could use the other endianness on a MIPS host.
63 mips_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00\x00\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'
64 mips_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff\xff\xff\xff\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x20'
67 mipsel_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'
68 mipsel_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\x00\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff\xff\xff\xff\xff\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x20\x00\x00\x00'
71 mipsn32_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00\x00\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x20'
72 mipsn32_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff\xff\xff\xff\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x20'
75 mipsn32el_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x20\x00\x00\x00'
76 mipsn32el_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\x00\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff\xff\xff\xff\xff\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x20\x00\x00\x00'
79 mips64_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08'
80 mips64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
83 mips64el_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x08\x00'
84 mips64el_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\x00\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
87 sh4_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2a\x00'
88 sh4_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
91 sh4eb_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x2a'
92 sh4eb_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
95 s390x_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x16'
96 s390x_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
99 aarch64_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7\x00'
100 aarch64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
103 aarch64_be_magic
='\x7fELF\x02\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7'
104 aarch64_be_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
105 aarch64_be_family
=armeb
107 hppa_magic
='\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x0f'
108 hppa_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
111 riscv32_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00'
112 riscv32_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
115 riscv64_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00'
116 riscv64_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
119 xtensa_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5e\x00'
120 xtensa_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
123 xtensaeb_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5e'
124 xtensaeb_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
125 xtensaeb_family
=xtensaeb
127 microblaze_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xba\xab'
128 microblaze_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
129 microblaze_family
=microblaze
131 microblazeel_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xab\xba'
132 microblazeel_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
133 microblazeel_family
=microblazeel
135 or1k_magic
='\x7fELF\x01\x02\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x5c'
136 or1k_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff'
139 hexagon_magic
='\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xa4\x00'
140 hexagon_mask
='\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
141 hexagon_family
=hexagon
143 loongarch64_magic
='\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x02\x01'
144 loongarch64_mask
='\xff\xff\xff\xff\xff\xff\xff\xfc\x00\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff'
145 loongarch64_family
=loongarch
148 cpu
=${HOST_ARCH:-$(uname -m)}
150 amd64|i386|i486|i586|i686|i86pc|BePC|x86_64
)
156 "Power Macintosh"|ppc64|powerpc|ppc
)
162 arm|armel|armhf|arm64|armv
[4-9]*l|aarch64
)
165 armeb|armv
[4-9]*b|aarch64_be
)
185 Usage
: qemu
-binfmt
-conf.sh
[--qemu
-path PATH
][--debian
][--systemd CPU
]
186 [--help][--credential
yes|no
][--exportdir PATH
]
187 [--persistent
yes|no
][--qemu
-suffix SUFFIX
]
188 [--preserve
-argv0
yes|no
]
190 Configure binfmt_misc to use qemu interpreter
192 --help: display this usage
193 --qemu
-path
: set path to qemu interpreter
($QEMU_PATH)
194 --qemu
-suffix
: add a suffix to the default interpreter name
195 --debian
: don
't write into /proc,
196 instead generate update-binfmts templates
197 --systemd: don't
write into
/proc
,
198 instead generate
file for systemd
-binfmt.service
199 for the given CPU. If CPU is
"ALL", generate a
200 file for all known cpus
201 --exportdir
: define where to
write configuration files
202 (default
: $SYSTEMDDIR or
$DEBIANDIR)
203 --credential
: if yes, credential and security tokens are
204 calculated according to the binary to interpret
205 --persistent
: if yes, the interpreter is loaded when binfmt is
206 configured and remains
in memory. All future uses
207 are cloned from the open
file.
208 --preserve
-argv0 preserve argv
[0]
210 To import templates with update
-binfmts
, use
:
212 sudo update
-binfmts
--importdir
${EXPORTDIR:-$DEBIANDIR} --import qemu
-CPU
214 To remove interpreter
, use
:
216 sudo update
-binfmts
--package qemu
-CPU
--remove qemu
-CPU
$QEMU_PATH
218 With systemd
, binfmt files are loaded by systemd
-binfmt.service
220 The environment variable HOST_ARCH allows to override
'uname' to generate
221 configuration files
for a different architecture than the current one.
230 qemu_check_access
() {
231 if [ ! -w
"$1" ] ; then
232 echo "ERROR: cannot write to $1" 1>&2
237 qemu_check_bintfmt_misc
() {
238 # load the binfmt_misc module
239 if [ ! -d
/proc
/sys
/fs
/binfmt_misc
]; then
240 if ! /sbin
/modprobe binfmt_misc
; then
244 if [ ! -f
/proc
/sys
/fs
/binfmt_misc
/register
]; then
245 if ! mount binfmt_misc
-t binfmt_misc
/proc
/sys
/fs
/binfmt_misc
; then
250 qemu_check_access
/proc
/sys
/fs
/binfmt_misc
/register
254 dpkg
--status
"$1" > /dev
/null
2>&1
257 qemu_check_debian
() {
258 if [ ! -e
/etc
/debian_version
] ; then
259 echo "WARNING: your system is not a Debian based distro" 1>&2
260 elif ! installed_dpkg binfmt
-support
; then
261 echo "WARNING: package binfmt-support is needed" 1>&2
263 qemu_check_access
"$EXPORTDIR"
266 qemu_check_systemd
() {
267 if ! systemctl
-q is
-enabled systemd
-binfmt.service
; then
268 echo "WARNING: systemd-binfmt.service is missing or disabled" 1>&2
270 qemu_check_access
"$EXPORTDIR"
273 qemu_generate_register
() {
275 if [ "$CREDENTIAL" = "yes" ] ; then
278 if [ "$PERSISTENT" = "yes" ] ; then
281 if [ "$PRESERVE_ARG0" = "yes" ] ; then
285 echo ":qemu-$cpu:M::$magic:$mask:$qemu:$flags"
288 qemu_register_interpreter
() {
289 echo "Setting $qemu as binfmt interpreter for $cpu"
290 qemu_generate_register
> /proc
/sys
/fs
/binfmt_misc
/register
293 qemu_generate_systemd
() {
294 echo "Setting $qemu as binfmt interpreter for $cpu for systemd-binfmt.service"
295 qemu_generate_register
> "$EXPORTDIR/qemu-$cpu.conf"
298 qemu_generate_debian
() {
299 cat > "$EXPORTDIR/qemu-$cpu" <<EOF
304 credentials
$CREDENTIAL
305 preserve
$PRESERVE_ARG0
306 fix_binary
$PERSISTENT
312 host_family
=$
(qemu_get_family
)
314 # register the interpreter for each cpu except for the native one
316 for cpu
in ${qemu_target_list} ; do
317 magic
=$
(eval echo \$
${cpu}_magic
)
318 mask
=$
(eval echo \$
${cpu}_mask
)
319 family
=$
(eval echo \$
${cpu}_family
)
321 if [ "$magic" = "" ] ||
[ "$mask" = "" ] ||
[ "$family" = "" ] ; then
322 echo "INTERNAL ERROR: unknown cpu $cpu" 1>&2
326 qemu
="$QEMU_PATH/qemu-$cpu"
327 if [ "$cpu" = "i486" ] ; then
328 qemu
="$QEMU_PATH/qemu-i386"
331 qemu
="$qemu$QEMU_SUFFIX"
332 if [ "$host_family" != "$family" ] ; then
338 CHECK
=qemu_check_bintfmt_misc
339 BINFMT_SET
=qemu_register_interpreter
341 SYSTEMDDIR
="/etc/binfmt.d"
342 DEBIANDIR
="/usr/share/binfmts"
344 QEMU_PATH
=/usr
/local/bin
350 _longopts
="debian,systemd:,qemu-path:,qemu-suffix:,exportdir:,help,credential:,\
351 persistent:,preserve-argv0:"
352 options
=$
(getopt
-o ds
:Q
:S
:e
:hc
:p
:g
:F
: -l
${_longopts} -- "$@")
353 eval set -- "$options"
358 CHECK
=qemu_check_debian
359 BINFMT_SET
=qemu_generate_debian
360 EXPORTDIR
=${EXPORTDIR:-$DEBIANDIR}
363 CHECK
=qemu_check_systemd
364 BINFMT_SET
=qemu_generate_systemd
365 EXPORTDIR
=${EXPORTDIR:-$SYSTEMDDIR}
367 # check given cpu is in the supported CPU list
368 if [ "$1" != "ALL" ] ; then
369 for cpu
in ${qemu_target_list} ; do
370 if [ "$cpu" = "$1" ] ; then
375 if [ "$cpu" = "$1" ] ; then
376 qemu_target_list
="$1"
378 echo "ERROR: unknown CPU \"$1\"" 1>&2