binfmt.d.xml revision 12b42c76672a66c2d4ea7212c14f8f1b5a62b78d
6ae232055d4d8a97267517c5e50074c2c819941and<?xml version="1.0"?>
6ae232055d4d8a97267517c5e50074c2c819941and<!--*-nxml-*-->
6ae232055d4d8a97267517c5e50074c2c819941and<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6ae232055d4d8a97267517c5e50074c2c819941and<!--
6ae232055d4d8a97267517c5e50074c2c819941and This file is part of systemd.
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and Copyright 2011 Lennart Poettering
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and systemd is free software; you can redistribute it and/or modify it
6ae232055d4d8a97267517c5e50074c2c819941and under the terms of the GNU Lesser General Public License as published by
6ae232055d4d8a97267517c5e50074c2c819941and the Free Software Foundation; either version 2.1 of the License, or
6ae232055d4d8a97267517c5e50074c2c819941and (at your option) any later version.
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and systemd is distributed in the hope that it will be useful, but
6ae232055d4d8a97267517c5e50074c2c819941and WITHOUT ANY WARRANTY; without even the implied warranty of
6ae232055d4d8a97267517c5e50074c2c819941and MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
6ae232055d4d8a97267517c5e50074c2c819941and Lesser General Public License for more details.
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and You should have received a copy of the GNU Lesser General Public License
6ae232055d4d8a97267517c5e50074c2c819941and along with systemd; If not, see <http://www.gnu.org/licenses/>.
6ae232055d4d8a97267517c5e50074c2c819941and-->
6ae232055d4d8a97267517c5e50074c2c819941and<refentry id="binfmt.d" conditional='ENABLE_BINFMT'
6ae232055d4d8a97267517c5e50074c2c819941and xmlns:xi="http://www.w3.org/2001/XInclude">
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refentryinfo>
6ae232055d4d8a97267517c5e50074c2c819941and <title>binfmt.d</title>
6ae232055d4d8a97267517c5e50074c2c819941and <productname>systemd</productname>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <authorgroup>
6ae232055d4d8a97267517c5e50074c2c819941and <author>
6ae232055d4d8a97267517c5e50074c2c819941and <contrib>Developer</contrib>
6ae232055d4d8a97267517c5e50074c2c819941and <firstname>Lennart</firstname>
6ae232055d4d8a97267517c5e50074c2c819941and <surname>Poettering</surname>
6ae232055d4d8a97267517c5e50074c2c819941and <email>lennart@poettering.net</email>
6ae232055d4d8a97267517c5e50074c2c819941and </author>
6ae232055d4d8a97267517c5e50074c2c819941and </authorgroup>
6ae232055d4d8a97267517c5e50074c2c819941and </refentryinfo>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refmeta>
6ae232055d4d8a97267517c5e50074c2c819941and <refentrytitle>binfmt.d</refentrytitle>
6ae232055d4d8a97267517c5e50074c2c819941and <manvolnum>5</manvolnum>
6ae232055d4d8a97267517c5e50074c2c819941and </refmeta>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refnamediv>
6ae232055d4d8a97267517c5e50074c2c819941and <refname>binfmt.d</refname>
6ae232055d4d8a97267517c5e50074c2c819941and <refpurpose>Configure additional binary formats for
6ae232055d4d8a97267517c5e50074c2c819941and executables at boot</refpurpose>
6ae232055d4d8a97267517c5e50074c2c819941and </refnamediv>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refsynopsisdiv>
6ae232055d4d8a97267517c5e50074c2c819941and <para><filename>/etc/binfmt.d/*.conf</filename></para>
6ae232055d4d8a97267517c5e50074c2c819941and <para><filename>/run/binfmt.d/*.conf</filename></para>
6ae232055d4d8a97267517c5e50074c2c819941and <para><filename>/usr/lib/binfmt.d/*.conf</filename></para>
6ae232055d4d8a97267517c5e50074c2c819941and </refsynopsisdiv>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and <title>Description</title>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <para>At boot,
6ae232055d4d8a97267517c5e50074c2c819941and <citerefentry><refentrytitle>systemd-binfmt.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
6ae232055d4d8a97267517c5e50074c2c819941and reads configuration files from the above directories to register
6ae232055d4d8a97267517c5e50074c2c819941and in the kernel additional binary formats for executables.</para>
6ae232055d4d8a97267517c5e50074c2c819941and </refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and <title>Configuration Format</title>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <para>Each file contains a list of binfmt_misc kernel binary
6ae232055d4d8a97267517c5e50074c2c819941and format rules. Consult <ulink
6ae232055d4d8a97267517c5e50074c2c819941and url="https://www.kernel.org/doc/Documentation/binfmt_misc.txt">binfmt_misc.txt</ulink>
6ae232055d4d8a97267517c5e50074c2c819941and for more information on registration of additional binary formats
6ae232055d4d8a97267517c5e50074c2c819941and and how to write rules.</para>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <para>Empty lines and lines beginning with ; and # are ignored.
6ae232055d4d8a97267517c5e50074c2c819941and Note that this means you may not use ; and # as delimiter in
6ae232055d4d8a97267517c5e50074c2c819941and binary format rules.</para>
6ae232055d4d8a97267517c5e50074c2c819941and </refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <xi:include href="standard-conf.xml" xpointer="confd" />
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and <title>Example</title>
6ae232055d4d8a97267517c5e50074c2c819941and <example>
6ae232055d4d8a97267517c5e50074c2c819941and <title>/etc/binfmt.d/wine.conf example:</title>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <programlisting># Start WINE on Windows executables
6ae232055d4d8a97267517c5e50074c2c819941and:DOSWin:M::MZ::/usr/bin/wine:</programlisting>
6ae232055d4d8a97267517c5e50074c2c819941and </example>
6ae232055d4d8a97267517c5e50074c2c819941and </refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and <title>See Also</title>
6ae232055d4d8a97267517c5e50074c2c819941and <para>
6ae232055d4d8a97267517c5e50074c2c819941and <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
6ae232055d4d8a97267517c5e50074c2c819941and <citerefentry><refentrytitle>systemd-binfmt.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
6ae232055d4d8a97267517c5e50074c2c819941and <citerefentry><refentrytitle>systemd-delta</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
6ae232055d4d8a97267517c5e50074c2c819941and <citerefentry project='die-net'><refentrytitle>wine</refentrytitle><manvolnum>8</manvolnum></citerefentry>
6ae232055d4d8a97267517c5e50074c2c819941and </para>
6ae232055d4d8a97267517c5e50074c2c819941and </refsect1>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and</refentry>
6ae232055d4d8a97267517c5e50074c2c819941and