binfmt.d(5)

1BINFMT.D(5)                        binfmt.d                        BINFMT.D(5)
2
3
4

NAME

6       binfmt.d - Configure additional binary formats for executables at boot
7

SYNOPSIS

9       /etc/binfmt.d/*.conf
10
11       /run/binfmt.d/*.conf
12
13       /usr/lib/binfmt.d/*.conf
14

DESCRIPTION

16       At boot, systemd-binfmt.service(8) reads configuration files from the
17       above directories to register in the kernel additional binary formats
18       for executables.
19

CONFIGURATION FORMAT

21       Each file contains a list of binfmt_misc kernel binary format rules.
22       Consult the kernel's binfmt-misc.rst[1] documentation file for more
23       information on registration of additional binary formats and how to
24       write rules.
25
26       Empty lines and lines beginning with ; and # are ignored. Note that
27       this means you may not use ; and # as delimiter in binary format rules.
28

CONFIGURATION DIRECTORIES AND PRECEDENCE

30       Configuration files are read from directories in /etc/, /run/, and
31       /usr/lib/, in order of precedence. Each configuration file in these
32       configuration directories shall be named in the style of filename.conf.
33       Files in /etc/ override files with the same name in /run/ and
34       /usr/lib/. Files in /run/ override files with the same name in
35       /usr/lib/.
36
37       Packages should install their configuration files in /usr/lib/. Files
38       in /etc/ are reserved for the local administrator, who may use this
39       logic to override the configuration files installed by vendor packages.
40       All configuration files are sorted by their filename in lexicographic
41       order, regardless of which of the directories they reside in. If
42       multiple files specify the same option, the entry in the file with the
43       lexicographically latest name will take precedence. It is recommended
44       to prefix all filenames with a two-digit number and a dash, to simplify
45       the ordering of the files.
46
47       If the administrator wants to disable a configuration file supplied by
48       the vendor, the recommended way is to place a symlink to /dev/null in
49       the configuration directory in /etc/, with the same filename as the
50       vendor configuration file. If the vendor configuration file is included
51       in the initrd image, the image has to be regenerated.
52

EXAMPLE

54       Example 1. /etc/binfmt.d/wine.conf example:
55
56           # Start WINE on Windows executables
57           :DOSWin:M::MZ::/usr/bin/wine:
58

NOTES

63        1. binfmt-misc.rst
64           https://www.kernel.org/doc/html/latest/admin-guide/binfmt-misc.html
65
66
67
68systemd 241                                                        BINFMT.D(5)