manjaro-tools/docbook/profile.conf.xml
2015-05-25 12:15:33 +02:00

251 lines
8.1 KiB
XML

<?xml version='1.0'?> <!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!--
This file is part of manjaro-tools.
Copyright 2015 Manjaro Developers
manjaro-tools is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
manjaro-tools is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->
<refentry id="profile.conf" xmlns:xi="http://www.w3.org/2001/XInclude">
<refentryinfo>
<title>profile.conf-+</title>
<productname>manjaro-tools</productname>
<authorgroup>
<author>
<contrib></contrib>
<firstname></firstname>
<surname></surname>
<email></email>
</author>
</authorgroup>
</refentryinfo>
<refmeta>
<refentrytitle>profile.conf</refentrytitle>
<manvolnum>5</manvolnum>
</refmeta>
<refnamediv>
<refname>profile.conf</refname>
<refpurpose>configuration file for the individual profiles </refpurpose>
</refnamediv>
<refsynopsisdiv>
<para><filename>profile.conf</filename></para>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>profile.conf is a configuration file used to modify how the ISO will be built. </para>
<para>By default all the options in the file are commented, with a value equal to the
default value. To change it just uncomment and put the desired value.</para>
</refsect1>
<refsect1>
<title>Options</title>
<para>The following options are understood:</para>
<variablelist>
<varlistentry>
<term><varname>initsys=</varname></term>
<listitem><para>Takes <option>systemd</option> (the default)
or <option>openrc</option>. Selecting and option will change
how the hostname, the displaymanager and services will be configured.
For services also controls if buildiso will use start_systemd and
start_systemd_live or start_openrc and start_openrc_live to determine
the default services that will be enabled automatically.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>displaymanager=</varname></term>
<listitem><para>Takes a value of
<option>lightdm</option>,
<option>sddm</option>,
<option>gdm</option>,
<option>mdm</option>,
<option>lxdm</option>. Defaults to "none" value,
which won't configure any display manager.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>default_desktop_executable=</varname></term>
<term><varname>default_desktop_file=</varname></term>
<listitem><para>Executable and desktop file used to set witch
desktop environment the display manager will run by default.
default_desktop_executable= defines a binary in /usr/bin and
default_desktop_file a .desktop file in /usr/share/xsessions,
skipping the .desktop part.
<screen>
default_desktop_executable=startxfce4
default_desktop_file=xfce
</screen>
If one or both values are not set or "none" (the default) buildiso
will try to autodetect the desktop environment.
</para>
<para>
Incomplete list of possible values:
</para>
<screen>
Desktop Desktop executable Desktop file
--------------------------------------------------------
Budgie budgie-session budgie-session
Cinnamon cinnamon-session cinnamon-session
Enlightenment enlightenment_start enlightenment
Gnome gnome-session gnome
i3 i3 i3
KDE Plasma 4 startkde kde-plasma
KDE Plasma 5 startkde plasma
LXDE lxsession LXDE
LXDE startlxde LXDE
LXQt lxqt-session lxqt
Mate mate-session mate
Openbox openbox-session openbox
Pantheon pantheon-session pantheon
PekWM pekwm pekwm
Xfce startxfce4 xfce
</screen>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>kernel=</varname></term>
<listitem><para>Takes a string corresponding to a
manjaro kernel package (ex: linux318 for linux 3.18).
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>efi_boot_loader=</varname></term>
<listitem><para>Takes grub or gummibot. Configures
calamares to use that bootloader.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>efi_part_size=</varname></term>
<listitem><para>Size in MiB of the fat partition where
the kernel is. This is useful if you add extra hooks
in the mkinitcpio.conf and it's to big to fit in the
partition. The default is "32M".
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>plymouth_theme=</varname></term>
<listitem><para>Takes the name of the plymouth
theme. It should be the directory of a valid
plymouth theme installed in /usr/share/plymouth/themes/
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>start_systemd=</varname></term>
<listitem><para>Array of services that will be
enabled in systemd systems. It has to match
the names of .service systemd files.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>start_openrc=</varname></term>
<listitem><para>Array of services that will be
enabled in openrc systems.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>hostname=</varname></term>
<listitem><para>Hostname for the ISO.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>username=</varname></term>
<listitem><para>Username of the default user
that will be created in the live-cd.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>password=</varname></term>
<listitem><para>Password of the default user
that will be created in the live-cd.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>addgroups=</varname></term>
<listitem><para>Default groups of the default user
in the live-cd and the user created while installing
the iso using calamares.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>start_systemd_live=</varname></term>
<listitem><para>Array of services that will be
enabled in the systemd live-cd. It has to match
the names of .service systemd files.
</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>start_openrc_live=</varname></term>
<listitem><para>Array of services that will be
enabled in the openrc live-cd.
</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry project='manjaro-tools'><refentrytitle>manjaro-tools.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry project='manjaro-tools'><refentrytitle>buildiso</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
</para>
</refsect1>
</refentry>