man/binfmt.d.xml

   1 <?xml version="1.0"?>
   2 <!--*-nxml-*-->
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4 <!--
   5   This file is part of systemd.
   6
   7   Copyright 2011 Lennart Poettering
   8
   9   systemd is free software; you can redistribute it and/or modify it
  10   under the terms of the GNU General Public License as published by
  11   the Free Software Foundation; either version 2 of the License, or
  12   (at your option) any later version.
  13
  14   systemd is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   General Public License for more details.
  18
  19   You should have received a copy of the GNU General Public License
  20   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  21 -->
  22 <refentry id="binfmt.d">
  23
  24         <refentryinfo>
  25                 <title>binfmt.d</title>
  26                 <productname>systemd</productname>
  27
  28                 <authorgroup>
  29                         <author>
  30                                 <contrib>Developer</contrib>
  31                                 <firstname>Lennart</firstname>
  32                                 <surname>Poettering</surname>
  33                                 <email>lennart@poettering.net</email>
  34                         </author>
  35                 </authorgroup>
  36         </refentryinfo>
  37
  38         <refmeta>
  39                 <refentrytitle>binfmt.d</refentrytitle>
  40                 <manvolnum>5</manvolnum>
  41         </refmeta>
  42
  43         <refnamediv>
  44                 <refname>binfmt.d</refname>
  45                 <refpurpose>Configure additional binary formats at boot</refpurpose>
  46         </refnamediv>
  47
  48         <refsynopsisdiv>
  49                 <para><filename>/etc/binfmt.d/*.conf</filename></para>
  50         </refsynopsisdiv>
  51
  52         <refsect1>
  53                 <title>Description</title>
  54
  55                 <para><command>systemd</command> uses
  56                 <filename>/etc/binfmt.d/</filename> to configure
  57                 additional binary formats to register during boot in
  58                 the kernel.  Each configuration file is named in the
  59                 style of
  60                 <filename>/etc/binfmt.d/&lt;program&gt;.conf</filename>.</para>
  61
  62
  63         </refsect1>
  64
  65         <refsect1>
  66                 <title>Configuration Format</title>
  67
  68                 <para>Each file contains a list of binfmt_misc kernel
  69                 binary format rules. Consult <ulink
  70                 url="http://www.kernel.org/doc/Documentation/binfmt_misc.txt">binfmt_misc.txt</ulink>
  71                 for more information on registration of additional
  72                 binary formats and how to write rules.</para>
  73
  74                 <para>Empty lines and lines beginning with ; and # are
  75                 ignored. Note that this means you may not use ; and #
  76                 as delimiter in binary format rules.</para>
  77
  78                 <para>Configuration files are loaded in alphabetical
  79                 order. To ensure that a specific rule takes precedence
  80                 over another place it in a file with an alphabetically
  81                 later name.</para>
  82
  83         </refsect1>
  84
  85         <refsect1>
  86                 <title>Example</title>
  87                 <example>
  88                         <title>/etc/binfmt.d/wine.conf example:</title>
  89
  90                         <programlisting># Start WINE on Windows executables
  91 :DOSWin:M::MZ::/usr/bin/wine:</programlisting>
  92                 </example>
  93         </refsect1>
  94
  95         <refsect1>
  96                 <title>See Also</title>
  97                 <para>
  98                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  99                         <citerefentry><refentrytitle>wine</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 100                 </para>
 101         </refsect1>
 102
 103 </refentry>