On Wed, 19 Aug 2009 09:32:37 +0200 Nicolas François <nicolas.francois@centraliens.net> wrote: > Hi Neil, > > Can you regenerate a POT file after applying the attached patch. Applied. > This should solve Américo's issues. The new string is: #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:384 msgid "" "Note that the Debian chroot program from coreutils expects you to want the " "same shell outside the chroot as you want to use inside the chroot. The " "typical Debian default shell in <filename>/etc/passwd</filename> is bash " "which is not present in the Emdebian rootfs so <command>chroot</command> " "needs the <option>/bin/sh</option> option." msgstr "" > The reason is that the po4a Xml module is very generic, and the > docbook module provides the definition for the XML Docbook format to > the Xml module. New POT file attached. (255 entries) -- Neil Williams ============= http://www.data-freedom.org/ http://www.linux.codehelp.co.uk/ http://e-mail.is-not-s.ms/
# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2009-08-19 10:23+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: ENCODING" #. type: Content of: <book><bookinfo><title> #: doc/xml/emdebian-rootfs.1.xml:9 msgid "emdebian-rootfs" msgstr "" #. type: Content of: <book><bookinfo> #: doc/xml/emdebian-rootfs.1.xml:10 msgid "<date>Sun 11 Jan 2009 19:55:45 GMT</date>" msgstr "" #. type: Content of: <book><bookinfo><releaseinfo> #: doc/xml/emdebian-rootfs.1.xml:11 msgid "Release: 1.8.0" msgstr "" #. type: Content of: <book><bookinfo><author><personblurb><para> #: doc/xml/emdebian-rootfs.1.xml:17 msgid "Debian and Emdebian developer." msgstr "" #. type: Content of: <book><bookinfo> #: doc/xml/emdebian-rootfs.1.xml:12 msgid "" "<orgname>Emdebian</orgname> <author> <firstname>Neil</firstname> " "<surname>Williams</surname> <placeholder type=\"personblurb\" id=\"0\"/> " "</author>" msgstr "" #. type: Content of: <book><bookinfo><legalnotice><title> #: doc/xml/emdebian-rootfs.1.xml:21 msgid "The GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007" msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/xml/emdebian-rootfs.1.xml:22 msgid "This documentation is part of emdebian-tools." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/xml/emdebian-rootfs.1.xml:23 msgid "" "emdebian-tools is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " "Software Foundation; either version 3 of the License, or (at your option) " "any later version." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/xml/emdebian-rootfs.1.xml:27 msgid "" "This program 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 General Public License for " "more details." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/xml/emdebian-rootfs.1.xml:31 msgid "" "You should have received a copy of the GNU General Public License along with " "this program. If not, see <ulink " "url=\"http://www.gnu.org/licenses/\">http://www.gnu.org/licenses/</ulink>." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><note> #: doc/xml/emdebian-rootfs.1.xml:35 msgid "<note>" msgstr "" #. type: Content of: <book><bookinfo><legalnotice><note><para> #: doc/xml/emdebian-rootfs.1.xml:36 msgid "" "In Debian you can find a copy of the GNU General Public Licence in " "<filename>/usr/share/common-licenses/GPL-3</filename>" msgstr "" #. type: Content of: <book><bookinfo><legalnotice> #: doc/xml/emdebian-rootfs.1.xml:38 msgid "</note>" msgstr "" #. type: Content of: <book><preface><title> #: doc/xml/emdebian-rootfs.1.xml:42 msgid "Emdebian Tools Reference" msgstr "" #. type: Content of: <book><preface><formalpara><title> #: doc/xml/emdebian-rootfs.1.xml:44 msgid "Purpose" msgstr "" #. type: Content of: <book><preface><formalpara><para> #: doc/xml/emdebian-rootfs.1.xml:45 msgid "" "This documentation consists primarily of the manpages for " "<emphasis>emdebian-tools</emphasis> but also contains useful references and " "links to further reading on a variety of topics related to Emdebian and " "cross building. It is intended to be read alongside the <ulink " "url=\"http://www.emdebian.org/\">Emdebian website</ulink> and <ulink " "url=\"http://wiki.debian.org/Embedded_Debian\">Emdebian Wiki</ulink>." msgstr "" #. type: Content of: <book><preface><para> #: doc/xml/emdebian-rootfs.1.xml:52 msgid "" "Some scripts embed the manpage content in the perl script as pod " "content. These manpages are listed separately in the HTML versions." msgstr "" #. type: Content of: <book><chapter><title> #: doc/xml/emdebian-rootfs.1.xml:56 msgid "Emdebian Tools manpages" msgstr "" #. type: Content of: <book><chapter><title> #: doc/xml/emdebian-rootfs.1.xml:62 msgid "Other manpages and external links" msgstr "" #. type: Content of: <book><chapter><para> #: doc/xml/emdebian-rootfs.1.xml:63 msgid "" "These manpages are generated from perl instead of XML and are not currently " "listed in the main table of contents. The HTML version is hosted separately:" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:67 msgid "Debian::Packages::Compare" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:68 msgid "" "<ulink url=\"DebianPackagesCompare.html\">Debian::Packages::Compare</ulink> " "manpage." msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:72 msgid "dh_gentdeb" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:73 msgid "<ulink url=\"dh_gentdeb.html\">dh_gentdeb</ulink> manpage." msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:76 msgid "dpkg-gentdeb" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:77 msgid "<ulink url=\"dpkg-gentdeb.html\">dpkg-gentdeb</ulink> manpage." msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:80 msgid "emtargetcmp" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:81 msgid "<ulink url=\"emtargetcmp.html\">emtargetcmp</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:84 msgid "emprunecross" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:85 msgid "<ulink url=\"emprunecross.html\">emprunecross</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:88 msgid "Emdebian::Tools" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:89 msgid "" "<ulink url=\"EmdebianTools.html\">Emdebian::Tools</ulink> function " "reference." msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:94 msgid "em_installtdeb" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:95 msgid "<ulink url=\"em_installtdeb.html\">em_installtdeb</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:98 msgid "emrecent" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:99 msgid "<ulink url=\"emrecent.html\">emrecent</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:102 msgid "emgrip" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:103 msgid "<ulink url=\"emgrip.html\">emgrip</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:106 msgid "em_autogrip" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:107 msgid "<ulink url=\"em_autogrip.html\">em_autogrip</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:110 msgid "emdebcheck" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:111 msgid "<ulink url=\"emdebcheck.html\">emdebcheck</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:114 msgid "emcache" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:115 msgid "<ulink url=\"emcache.html\">emcache</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:118 msgid "emdepends" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:119 msgid "<ulink url=\"emdepends.html\">emdepends</ulink> manpage" msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:122 msgid "splitout_tdeb" msgstr "" #. type: Content of: <book><chapter><refsect1><para> #: doc/xml/emdebian-rootfs.1.xml:123 msgid "<ulink url=\"splitout_tdeb.html\">dplitout_tdeb</ulink> manpage." msgstr "" #. type: Content of: <book><chapter><refsect1><title> #: doc/xml/emdebian-rootfs.1.xml:126 msgid "WWW references" msgstr "" #. type: Content of: <book><chapter><refsect1><itemizedlist><listitem><para> #: doc/xml/emdebian-rootfs.1.xml:130 msgid "<ulink url=\"http://www.emdebian.org/\">Emdebian.org website</ulink>" msgstr "" #. type: Content of: <book><chapter><refsect1><itemizedlist><listitem><para> #: doc/xml/emdebian-rootfs.1.xml:135 msgid "" "<ulink " "url=\"http://www.linux.codehelp.co.uk/emdebian/depends.html\">Emdebian " "dependency maps</ulink>" msgstr "" #. type: Content of: <book><chapter><refsect1><itemizedlist><listitem><para> #: doc/xml/emdebian-rootfs.1.xml:140 msgid "" "<ulink url=\"http://www.linux.codehelp.co.uk/emdebian/\">Emdebian " "presentation</ulink>" msgstr "" #. type: Content of: <refentry><refentryinfo> #: doc/xml/empbuilderlib.3.xml:4 msgid "<productname>empbuilderlib</productname> <productnumber/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/xml/empbuilderlib.3.xml:8 doc/xml/empbuilderlib.3.xml:14 msgid "empbuilderlib" msgstr "" #. type: Content of: <refentry><refmeta><manvolnum> #: doc/xml/empbuilderlib.3.xml:9 doc/xml/emrootfslib.3.xml:9 msgid "3" msgstr "" #. type: Content of: <refentry><refmeta><refmiscinfo> #: doc/xml/empbuilderlib.3.xml:10 doc/xml/empbuilderlib.3.xml:11 doc/xml/emrootfslib.3.xml:10 doc/xml/emrootfslib.3.xml:11 msgid "EMDEBIAN-ROOTFS" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: doc/xml/empbuilderlib.3.xml:15 msgid "Common functions for Emdebian chroots" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/empbuilderlib.3.xml:18 doc/xml/emrootfslib.3.xml:18 doc/xml/emsandbox.1.xml:86 msgid "DESCRIPTION" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:19 msgid "" "<emphasis>empbuilderlib</emphasis> is intended solely for use on the build " "machine. Do not use these functions in second_stage_install ! " "<emphasis>empbuilderlib</emphasis> requires <emphasis " "role=\"bold\">perl</emphasis>!" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:23 msgid "" "<emphasis>empbuilderlib</emphasis> is a shell library which requires perl " "and pbuilder (which means bash!). <emphasis>empbuilderlib</emphasis> draws " "in POSIX shell functions from emrootfslib to be able to call in functions " "from first_stage_install within debootstrap. The only reasons to continue " "putting new functions in here are if:" msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: doc/xml/empbuilderlib.3.xml:31 msgid "The functions are only useful to create cross-building chroots OR" msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: doc/xml/empbuilderlib.3.xml:34 msgid "" "the functions need to call pbuilder code directly and are not necessary " "within first_stage_install." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:39 msgid "" "There should be no need to call pbuilder code within scripts that generate a " "root filesystem." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/empbuilderlib.3.xml:43 msgid "autoclean_aptcache" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:44 msgid "" "Same as the pbuilder option but run by default in " "<command>empdebuild</command> to remove obsolete .deb archives from the apt " "cache directories used by <command>empdebuild</command>." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/empbuilderlib.3.xml:50 msgid "copy_host_configuration" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:51 msgid "" "Copy hosts, hostname and resolv.conf from the system /etc/ directory and " "adapts /etc/hostname to use a different name (emdebian-$ARCH)." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/empbuilderlib.3.xml:57 msgid "extractembuildplace" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:58 doc/xml/emrootfslib.3.xml:84 msgid "" "Modified version of the equivalent function in pbuilder-modules to extract " "the compressed chroot (used by empdebuild)." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/empbuilderlib.3.xml:62 doc/xml/emrootfslib.3.xml:199 doc/xml/emsandbox.1.xml:438 msgid "Author" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:63 doc/xml/emrootfslib.3.xml:200 msgid "" "<emphasis>empbuilderlib</emphasis> was written by Neil Williams " "<email>codehelp@debian.org</email>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:66 doc/xml/emrootfslib.3.xml:203 doc/xml/emsandbox.1.xml:442 msgid "" "This manual page was written by Neil Williams " "<email>codehelp@debian.org</email>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/empbuilderlib.3.xml:71 doc/xml/emrootfslib.3.xml:208 doc/xml/emsandbox.1.xml:447 msgid "SEE ALSO" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/empbuilderlib.3.xml:72 msgid "" "See also <filename>apt-cross</filename> (1), <filename>dpkg-cross</filename> " "(1), <emphasis>emdebian-tools</emphasis> (1), " "<filename>emrootfslib</filename> (3)." msgstr "" #. type: Content of: <refentry><refentryinfo> #: doc/xml/emrootfslib.3.xml:4 msgid "<productname>emrootfslib</productname> <productnumber/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/xml/emrootfslib.3.xml:8 doc/xml/emrootfslib.3.xml:14 msgid "emrootfslib" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: doc/xml/emrootfslib.3.xml:15 msgid "Common functions for Emdebian root filesystems" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:19 msgid "" "<emphasis>emrootfslib</emphasis> is intended solely for use on the build " "machine. Do not use these functions in second_stage_install ! " "<emphasis>emrootfslib</emphasis> requires <emphasis " "role=\"bold\">perl</emphasis>!" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:23 msgid "" "There should be no need to call pbuilder code within scripts that generate a " "root filesystem and bash code must not be used in " "<emphasis>emrootfslib</emphasis>." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:28 msgid "basic_etc_fstab" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:29 msgid "" "Removing packages from the normal Debian debootstrap set can mean that " "certain critical files can be omitted. basic_etc_fstab creates a basic " "version of $TARGET/etc/fstab where it does not already exist." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:36 msgid "basic_group_setup" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:37 msgid "" "Removing packages from the normal Debian debootstrap set can mean that " "certain critical files can be omitted. basic_group_setup creates a basic " "version of $TARGET/etc/group where it does not already exist." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:44 msgid "basic_passwd_setup" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:45 msgid "" "Removing packages from the normal Debian debootstrap set can mean that " "certain critical files can be omitted. basic_passwd_setup creates a basic " "version of $TARGET/etc/passwd where it does not already exist." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:52 msgid "busybox_inittab" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:53 msgid "Note: this function overwrites an existing $TARGET/etc/inittab" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:55 msgid "" "busybox does not support runlevels and so the /etc/inittab file needs to be " "modified to support busybox. Currently, this function overwrites an existing " "$TARGET/etc/inittab - this is likely to change in future versions." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:62 msgid "busybox_rcS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:63 msgid "Note: this function overwrites an existing $TARGET/etc/init.d/rcS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:65 msgid "" "busybox does not support runlevels and so the /etc/init.d/rcS script needs " "to be modified to support busybox. Currently, this function overwrites an " "existing $TARGET/etc/init.d/rcS - this is likely to change in future " "versions." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:72 msgid "check_dirs" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:73 msgid "" "Check that the $BUILDPLACE, $BUILDRESULT and $APTCACHE directories exist " "(used by empdebuild)." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:77 msgid "checkarch" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:78 msgid "" "Calls check_arch from Debian::DpkgCross using perl. The perl call dies if " "the specified string does not match a supported architecture." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:83 msgid "create_emdebiantgz" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:88 msgid "disable_apt_recommends" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:89 msgid "Enforces a default of not installing recommended packages inside the chroot." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:94 msgid "extra_etc_rcd" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:95 msgid "" "Removing packages from the normal Debian debootstrap set can mean that " "certain critical files can be omitted. extra_etc_rcd creates a basic version " "of $TARGET/etc/rcS.d where it does not already exist." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:102 msgid "make_dpkg_dirs" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:103 msgid "" "Prepare for unpacking and general dpkg work by setting up " "$TARGET/var/lib/dpkg/status and $TARGET/var/lib/dpkg/available." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:108 msgid "prepare_proc" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:109 msgid "" "Ensure that $TARGET/proc and $TARGET/sys exist so that proc and sys can be " "mounted automatically." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:114 msgid "prepare_var" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:115 msgid "" "Ensure that $TARGET/var/log/ and $TARGET/var/spool exist so that various " "installation routines can proceed." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:120 msgid "set_approx_time" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:121 msgid "" "Normal Debian installations have a network connection and typical Debian " "desktop boxes also have a backup battery. Some embedded machines do not have " "either of these systems, making it impossible to store or retrieve even a " "vaguely close indication of the current time." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:127 msgid "" "set_approx_time uses the systems available on the build machine to store an " "approximate indication of the time that the root filesystem was created and " "write that time to a file in the root filesystem itself. For most purposes, " "this is sufficient for the purposes of setting up the root filesystem to the " "point where a network connection can be created and a call can be made to an " "internet clock using <command>ntpdate-debian</command>." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:137 msgid "set_cdebconf_default" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:138 msgid "" "Adds \"export DEBCONF_USE_CDEBCONF=true\" to $TARGET/etc/profile for " "cdebconf support." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:143 msgid "symlink_rcS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:144 msgid "" "Call repeatedly to create init symlinks, using the template " "$TARGET/etc/rcS.d/S$number$file" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emrootfslib.3.xml:150 msgid "<option>file</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emrootfslib.3.xml:153 msgid "file is the filename in $TARGET/etc/init.d/" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emrootfslib.3.xml:159 msgid "<option>number</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emrootfslib.3.xml:162 msgid "number is the number for the link in the init sequence." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:169 msgid "unpack_debootstrap" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:170 msgid "" "Specialized routine that replaces the normal second stage of debootstrap " "(you may consider it a series of hacks if you prefer). unpack uses dpkg to " "extract the files from the .deb package and process the control " "information. Unlike <command>dpkg</command> <option>--unpack</option>, the " "unpack routine does <emphasis role=\"bold\">NOT</emphasis> run any " "maintainer scripts which would inevitably fail in a cross built " "environment. Instead, it updates the relevant dpkg status and database " "files in the root filesystem and leaves the package in the unpacked state." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:180 msgid "" "unpack_debootstrap also sets up the busybox applets - future versions may " "split this functionality into a separate function." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:183 msgid "" "unpack_debootstrap also performs checks on /usr/sbin/invoke-rc.d and " "/usr/sbin/update-rc.d - future versions may split this functionality into a " "separate function." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:187 msgid "" "Finally, unpack_debootstrap removes all .deb package files from " "/var/cache/apt/archives. The remaining task (dpkg --configure -a) is " "performed via emsecondstage." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emrootfslib.3.xml:192 msgid "x_feign_install" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:193 msgid "" "Copied from debootstrap suite scripts to make a basic installation of a .deb " "package - although this is the basis of unpack_debootstrap, it is only " "really used for dpkg itself." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emrootfslib.3.xml:209 msgid "" "See also <filename>apt-cross</filename> (1), <filename>dpkg-cross</filename> " "(1), <emphasis>emdebian-tools</emphasis> (1), " "<filename>empdebuilderlib</filename> (3)." msgstr "" #. type: Content of: <refentry><refentryinfo> #: doc/xml/emsandbox.1.xml:4 msgid "<productname>emsandbox</productname> <productnumber/>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/xml/emsandbox.1.xml:8 doc/xml/emsandbox.1.xml:14 msgid "emsandbox" msgstr "" #. type: Content of: <refentry><refmeta><manvolnum> #: doc/xml/emsandbox.1.xml:9 msgid "1" msgstr "" #. type: Content of: <refentry><refmeta><refmiscinfo> #: doc/xml/emsandbox.1.xml:10 doc/xml/emsandbox.1.xml:11 msgid "EMDEBIAN-TOOLS" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: doc/xml/emsandbox.1.xml:15 msgid "create Emdebian root filesystems" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: doc/xml/emsandbox.1.xml:19 msgid "" "<command>emsandbox</command> <group> <arg>-a</arg> <arg>--arch </arg> " "<replaceable> ARCHITECTURE</replaceable> </group> <group> " "<arg>--create</arg> <arg>create</arg> </group> <group> <group> <arg>-s</arg> " "<arg>--script</arg> </group> <replaceable> FILENAME</replaceable> </group> " "<group> <arg>-S</arg> <arg>--suite</arg> <replaceable> NAME</replaceable> " "</group> <group> <arg>--machine-path</arg> <replaceable>PATH</replaceable> " "</group> <group> <arg>-m</arg> <arg>--machine</arg> <replaceable> " "NAME</replaceable> <group> <arg>-v</arg> <arg>--variant</arg> <replaceable> " "NAME</replaceable> </group> </group>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:58 msgid "SHELL INTERPRETERS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:59 msgid "" "<command>emsandbox</command> is bash code and uses " "<command>embootstrap</command> which is bash code and also sources pbuilder " "code which is also bash code. <command>debootstrap</command> re-executes " "itself with the default shell and then tries to source the suite script " "which fails because the re-executed copy of debootstrap is now running under " "the default shell, not bash." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:66 msgid "This problem can show up as a failure within <command>debootstrap</command>" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/xml/emsandbox.1.xml:69 #, no-wrap msgid "" "I: Retrieving zlib1g\n" "I: Validating zlib1g\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:72 msgid "The next line should be:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/xml/emsandbox.1.xml:74 #, no-wrap msgid "" "I: Extracting base-passwd...\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:76 msgid "" "Unfortunately, this is a result of the default shell interpreter in Debian " "being changed after the scripts were written and it is a non-trivial " "problem. It is not possible for <command>embootstrap</command> could migrate " "to cdebootstrap currently." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:81 msgid "" "The only current solution is to change your default shell to /bin/bash " "inside the environment running <command>emsandbox</command>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:87 msgid "" "<command>emsandbox</command> supports customised generation of basic root " "filesystems from cross-built Emdebian packages, ready for unpacking and " "configuring on an embedded device." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:91 msgid "" "Note that <filename>emsandbox</filename> does not support all the options " "available to <filename>debootstrap</filename>. Some of the debootstrap " "options that are supported are implemented as machine specific configuration " "files in your Emdebian work directory. (See <option>--machine</option> and " "<option>--variant</option>.)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:97 msgid "" "<filename>emsandbox</filename> is a wrapper for debootstrap to prepare an " "Emdebian root filesystem, using Emdebian packages and a native chroot via " "'debootstrap --foreign' and code from pbuilder." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:101 msgid "" "The Emdebian rootfs, as generated by <command>emsandbox</command> is not " "fully configured - packages are unpacked and certain support files are " "created but none of the packages are configured (not even the pre-install " "scripts). This last stage is the only process that <emphasis>must</emphasis> " "be run on the actual device <emphasis>before the first boot</emphasis>, " "using the <command>emsecondstage</command> script which requires a working " "<command>chroot</command> environment. Typically, " "<command>emsecondstage</command> is run from some kind of minimal bootloader " "environment that has sufficient support for mounting subsystems like proc " "and filesystems like the root filesystem partition and can chroot into the " "root filesystem. This method means that the majority of the work of creating " "the root filesystem can be done on the build machine." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:115 msgid "" "The tarball created by <command>emsandbox</command> should be copied onto " "the target device and unpacked using:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/xml/emsandbox.1.xml:119 #, no-wrap msgid "" "# cd /mnt/target/dir\n" "# tar -xzpf emdebian-arm.tgz\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:122 msgid "" "Immediately after unpacking, start the package configuration by running " "<command>./emsecondstage</command> on the target device. (Configuration " "involves running the cross-built binaries and is the only part of the " "process that must be run on the target device.)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:127 msgid "" "<command>emsecondstage</command> should <emphasis>always</emphasis> be run " "from the directory into which it was installed." msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/xml/emsandbox.1.xml:131 #, no-wrap msgid "" "# ./emsecondstage\n" " " msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:135 msgid "COMMANDS" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:138 msgid "<option>--create</option>|<option>create</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:140 msgid "" "Runs <command>debootstrap</command> <option>--foreign</option> with a " "modified suite rule set to create a basic Emdebian rootfs." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:143 msgid "Checks for an existing chroot and exits if one is found." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:148 msgid "<option>-h</option>|<option>--help</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:150 doc/xml/emsandbox.1.xml:158 msgid "print the usage message and exit." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:155 msgid "<option>--version</option>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:164 msgid "OPTIONS" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:167 msgid "" "<option>-a</option>|<option>--arch</option><replaceable> " "ARCHITECTURE</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:169 msgid "" "Override the <command>dpkg-cross</command> default architecture for this " "operation on the chroot." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:175 msgid "" "<option>-s</option>|<option>--script</option><replaceable> " "FILENAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:177 msgid "" "Override the default package selection and installation script with a " "customised debootstrap suite script (written in shell and compatible with " "whichever shell interpreter is to be installed on the target)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:182 msgid "" "Some customised scripts are provided with emdebian-tools. The default uses " "the standard Emdebian 'busybox' package with 'dpkg' and 'apt'. Replacement " "scripts need to be full debootstrap suite shell scripts that specify how to " "complete the first and second stage installations." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:188 msgid "" "Customised scripts packages with <emphasis>emdebian-tools</emphasis> include " "scripts for a root filesystem including libgtk2.0-0 and a complete GPE root " "filesystem." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:195 msgid "<option>--machine-path</option> <replaceable> PATH</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:199 msgid "" "Override the default path to machine and variant configuration. By default, " "emsandbox uses <filename>${WORK}/machine</filename> where " "<userinput>$WORK</userinput> is the working directory specified to " "<emphasis>emdebian-tools</emphasis> in the debconf configuration. The " "specified path must already exist and contain the relevant " "<filename>packages.conf</filename> configuration as well as the " "<filename>setup.sh</filename> and <filename>config.sh</filename> shell " "scripts (which may be empty)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:208 msgid "" "Examples of <filename>packages.conf</filename>, " "<filename>setup.sh</filename> and <filename>config.sh</filename> are in " "<filename>/usr/share/doc/emdebian-rootfs/examples/</filename>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:215 msgid "" "<option>-m</option>|<option>--machine</option><replaceable> " "MACHINE</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:217 msgid "" "Load machine specific configuration data from your Emdebian working " "directory. If no variant is specified, config is read from " "<filename>$WORK/machine/$MACHINE/default/</filename> where $WORK is the work " "directory specified in debconf for emdebian-tools." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:225 msgid "" "<option>-v</option>|<option>--variant</option><replaceable> " "VARIANT</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:227 msgid "" "Load variant specific configuration data from your Emdebian working " "directory. Requires <option>--machine</option>. Configuration data is read " "from <filename>$WORK/machine/$MACHINE/$VARIANT/</filename> where $WORK is " "the work directory specified in debconf for emdebian-tools." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:235 msgid "<option>-S</option>|<option>--suite</option><replaceable> NAME</replaceable>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:237 doc/xml/emsandbox.1.xml:352 msgid "" "Override the default suite [unstable] and specify another supported " "suite. Note that if the Emdebian repository is used, the suite chosen " "<emphasis>must</emphasis> be a normal Emdebian/Debian suite name from " "'unstable, testing or sid', or a Debian release codename for a release " "including or later than lenny. No other suite name is supported in Emdebian." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:244 doc/xml/emsandbox.1.xml:359 msgid "" "The selected suite is set in the root filesystem as the default suite for " "apt to use when looking for updates." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:252 msgid "Machine variants" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:253 msgid "" "<command>emsandbox</command> supports a set of customisation routines for " "each combination of machine and variant, allowing the rootfs to be " "customised to specific variants of a specific machine. Configuration data is " "stored in the <filename>machine</filename> subdirectory of your Emdebian " "work directory. Using the <option>-m</option> option to " "<command>emsandbox</command> loads <filename>packages.conf</filename> from " "the <filename>$WORK/machine/$MACHINE/default</filename> subdirectory prior " "to starting debootstrap. Once the first stage install is complete, " "<command>emsandbox</command> calls <filename>setup.sh</filename> from the " "same directory, passing the location and architecture of the tarball, so " "that other fine tuning can take place prior to creating the tarball. At this " "stage, any operations inside the rootfs must not try to execute any binaries " "within the rootfs. Immediately before creating the tarball, " "<filename>config.sh</filename> is copied into the " "<filename>/machine/$MACHINE/default/</filename> directory of the rootfs, " "ready to be called when <command>emsecondstage</command> has completed the " "second stage of the debootstrap process." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:269 msgid "" "Skeleton versions of <filename>packages.conf</filename>, " "<filename>setup.sh</filename> and <filename>config.sh</filename> are " "available in <filename>/usr/share/emdebian-tools/machine/</filename>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:273 msgid "" "<filename>packages.conf</filename> is intended to be the principal place for " "adjusting the emsandbox tarball to suit the needs of specific machine " "variants. <filename>setup.sh</filename> and <filename>config.sh</filename> " "can fine tune the results but in order to avoid reinventing the wheel, if " "more than a few machines need similar adjustments to the same files, future " "versions of <filename>packages.conf</filename> will collate those into a " "single configuration parameter available to all." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:281 msgid "<filename>packages.conf</filename> supports:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:285 msgid "<option>INCLUDE</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:288 msgid "" "Add a comma separated list of package names to the list of packages added to " "the tarball and installed in the second stage. Currently, debootstrap has " "problems with multiple repositories so either upload this package to the " "same repository as your other packages or create an apt-proxy that can serve " "as a local repository, set it in <option>PROXY</option> and specify a usable " "mirror for the device in <option>MIRROR</option>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:294 doc/xml/emsandbox.1.xml:332 msgid "DEFAULT: empty" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:299 msgid "<option>SCRIPT</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:302 msgid "" "Overrides the default emsandbox suite-script that debootstrap uses to " "determine the base and required packages and the all important sequence in " "which the packages can be installed. SCRIPT can be overridden on the " "emsandbox command line." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:306 msgid "DEFAULT: <filename>/usr/share/emdebian-tools/emdebian.crossd</filename>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:311 msgid "<option>MIRROR</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:314 msgid "" "Overrides the default emsandbox mirror. This repository will be set in " "<filename>/etc/apt/sources.list</filename> and will also be used by " "debootstrap to obtain all packages for the tarball unless " "<option>PROXY</option> is also set." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:318 msgid "DEFAULT: http://www.emdebian.org/crush/" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:323 msgid "<option>PROXY</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:326 msgid "" "Specifies a separate repository to pass to debootstrap that may be local or " "otherwise not intended for use once the tarball is installed. Use " "<option>MIRROR</option> to set the same value in debootstrap and " "<filename>/etc/apt/sources.list</filename>. If <option>PROXY</option> is " "specified without <option>MIRROR</option>, the default emsandbox MIRROR " "(http://buildd.emdebian.org/emdebian/) will be written into " "<filename>/etc/apt/sources.list</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:337 msgid "<option>TARBALL_NAME</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:340 msgid "" "Overrides the default name (emdebian-$ARCH) of the tarball. Do not specify a " "path here, just a filename with the .tgz suffix." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:342 msgid "" "DEFAULT: emdebian-$ARCH.tgz where $ARCH is specified to emsandbox or as the " "dpkg-cross default architecture." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/xml/emsandbox.1.xml:349 msgid "<option>SUITE</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:362 msgid "Not recommended to be changed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/xml/emsandbox.1.xml:364 msgid "DEFAULT: unstable" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:369 msgid "" "Due to limitations in the current debootstrap support, the only way of " "adding packages to the first stage is by providing a customised suite " "script. Even if emsandbox migrates to using a tool from Stag to overcome " "shortcomings in debootstrap, support for packages.conf, setup.sh and " "config.sh will remain." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:376 msgid "Automating rootfs builds" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:377 msgid "" "Providing you are trying to build a root filesystem for an architecture " "supported within Debian, <emphasis>emdebian-tools</emphasis> can help you " "automate the package builds. See <filename>em_autobuild</filename> (1)" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:383 msgid "SHELL variables" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:384 msgid "" "Note that the Debian chroot program from coreutils expects you to want the " "same shell outside the chroot as you want to use inside the chroot. The " "typical Debian default shell in <filename>/etc/passwd</filename> is bash " "which is not present in the Emdebian rootfs so <command>chroot</command> " "needs the <option>/bin/sh</option> option." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/xml/emsandbox.1.xml:391 msgid "FILES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:392 msgid "" "Most <emphasis>emdebian-tools</emphasis> use configuration data from " "<filename>apt-cross</filename> and <filename>dpkg-cross</filename>. " "<command>emsource</command> and <command>emsandbox </command> also support " "configuration using <filename>debconf</filename> to set a subversion " "username and default working directory (which must be writable) for " "unpacking source downloads. Default debconf values can be overridden with " "user-specific values using <filename>~/.apt-cross/emsource</filename> or " "<filename>~/.apt-cross/emsandbox</filename> respectively." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: doc/xml/emsandbox.1.xml:402 msgid "/etc/emsandbox.conf" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: doc/xml/emsandbox.1.xml:403 msgid "" "System-wide configuration file handled by <command>debconf</command> " "controlling unpacking source archives to a default working directory. Can " "also include a subversion username setting, intended for single-user " "installations. <filename>/etc/emsandbox.conf</filename> settings can be " "overridden on a per-user basis by copying the current file to " "<filename>~/.apt-cross/emsandbox</filename> and editing the values." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: doc/xml/emsandbox.1.xml:410 msgid "" "Two variables can be set (see also " "<filename>/etc/emsandbox.conf</filename>):" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><itemizedlist><listitem><para> #: doc/xml/emsandbox.1.xml:414 msgid "" "<emphasis>workingdir</emphasis>: A simple default location for " "<command>emsandbox</command> to create a source tree to download and unpack " "prebuilt binary packages. If left blank, a new top level directory tree is " "used but this is intended for chroot support only." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><itemizedlist><listitem><para> #: doc/xml/emsandbox.1.xml:422 msgid "" "<emphasis>targetsuite</emphasis>: Emdebian follows Debian by defaulting to " "building against unstable. This setting determines the versions of libraries " "and packages linked against the cross-built emdebian packages." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: doc/xml/emsandbox.1.xml:431 msgid "~/.apt-cross/emsandbox" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> #: doc/xml/emsandbox.1.xml:432 msgid "" "User-specific version of <filename>/etc/emsandbox.conf</filename>, " "supporting the same variables to provide user-specific overrides." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:439 msgid "" "<command>emsandbox</command> was written by Neil Williams " "<email>codehelp@debian.org</email>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/xml/emsandbox.1.xml:448 msgid "" "See also <filename>apt-cross</filename> (1), <filename>em_make</filename> " "(1), <filename>dpkg-cross</filename> (1), " "<emphasis>emdebian-tools</emphasis> (1)." msgstr "" #. type: =head1 #: em_multistrap:508 msgid "Name" msgstr "" #. type: textblock #: em_multistrap:510 msgid "em_multistrap - extends debootstrap for multiple repository support" msgstr "" #. type: =head1 #: em_multistrap:512 msgid "Synopsis" msgstr "" #. type: verbatim #: em_multistrap:514 #, no-wrap msgid "" " em_multistrap [-a ARCH] [-d DIR] -f CONFIG_FILE\n" " em_multistrap -?|-h|--help|--version\n" "\n" msgstr "" #. type: =head1 #: em_multistrap:517 msgid "Options" msgstr "" #. type: textblock #: em_multistrap:519 msgid "(These options can also be set in the configuration file.)" msgstr "" #. type: textblock #: em_multistrap:521 msgid "" "--tidy-up - remove apt cache data, downloaded Packages files and the apt " "package cache. Same as cleanup=true." msgstr "" #. type: textblock #: em_multistrap:524 msgid "" "--no-auth - allow the use of unauthenticated repositories. Same as " "noauth=true" msgstr "" #. type: =head1 #: em_multistrap:527 msgid "Description" msgstr "" #. type: textblock #: em_multistrap:529 msgid "" "em_multistrap provides a debootstrap-like method based on apt and extended " "to provide support for multiple repositories, using a configuration file to " "specify the relevant suites, architecture, extra packages and the mirror to " "use for each debootstrap." msgstr "" #. type: textblock #: em_multistrap:534 msgid "" "The aim is to create a complete debootstrap with all packages installed and " "configured, instead of just the base system." msgstr "" #. type: textblock #: em_multistrap:537 msgid "Example configuration:" msgstr "" #. type: verbatim #: em_multistrap:539 #, no-wrap msgid "" " [General]\n" " arch=armel\n" " directory=/opt/multistrap/\n" " # same as --tidy-up option if set to true\n" " cleanup=true\n" " # same as --no-auth option if set to true\n" " # keyring packages listed in each debootstrap will\n" " # still be installed.\n" " noauth=false\n" " # extract all downloaded archives (default is true)\n" " unpack=true\n" " # the order of sections is not important.\n" " # the debootstrap option determines which repository\n" " # is used to calculate the list of Priority: required packages.\n" " debootstrap=Debian\n" " \n" msgstr "" #. type: verbatim #: em_multistrap:555 #, no-wrap msgid "" " [Debian]\n" " packages=\n" " source=http://ftp.uk.debian.org/debian\n" " keyring=debian-archive-keyring\n" " suite=lenny\n" "\n" msgstr "" #. type: textblock #: em_multistrap:561 msgid "" "This will result in a completely normal debootstrap of Debian lenny from the " "specified mirror, for armel in '/opt/multistrap/'." msgstr "" #. type: textblock #: em_multistrap:564 msgid "" "Specify a package to extend the multistrap to include that package and all " "dependencies." msgstr "" #. type: textblock #: em_multistrap:567 msgid "" "Specify more debootstraps by adding new sections. Section names are used in " "the debootstrap general option." msgstr "" #. type: textblock #: em_multistrap:570 msgid "Section names are case-insensitive." msgstr "" #. type: textblock #: em_multistrap:572 msgid "e.g. change" msgstr "" #. type: verbatim #: em_multistrap:574 #, no-wrap msgid "" " debootstrap=Debian\n" "\n" msgstr "" #. type: textblock #: em_multistrap:576 msgid "to" msgstr "" #. type: verbatim #: em_multistrap:578 #, no-wrap msgid "" " debootstrap=Grip\n" " \n" msgstr "" #. type: verbatim #: em_multistrap:580 #, no-wrap msgid "" "then add the new section for Grip:\n" " \n" msgstr "" #. type: verbatim #: em_multistrap:582 #, no-wrap msgid "" " [Grip]\n" " packages=locales\n" " keyring=emdebian-archive-keyring\n" " source=http://www.emdebian.org/grip\n" " suite=lenny\n" "\n" msgstr "" #. type: textblock #: em_multistrap:588 msgid "" "Setting Grip instead of Debian in the debootstrap option, as above, will " "provide a base system from Emdebian Grip 1.0 and locate any missing " "dependencies in Debian 5.0 Lenny, allowing you to add any package(s) you " "need from Debian that are not yet in Emdebian Grip." msgstr "" #. type: textblock #: em_multistrap:593 msgid "" "All dependencies are resolved only by apt, using all configured " "repositories, to use only the most recent and most suitable " "dependencies. Note that multistrap turns off Install-Recommends so if the " "multistrap needs a package that is only a Recommended dependency, the " "recommended package needs to be specified in the packages line explicitly." msgstr "" #. type: textblock #: em_multistrap:600 msgid "" "'Architecture' and 'directory' can be overridden on the command line. Other " "general options have command line options, except debootstrap itself." msgstr "" #. type: =head1 #: em_multistrap:604 msgid "General settings:" msgstr "" #. type: textblock #: em_multistrap:606 msgid "" "'directory' specifies the top level directory where the debootstrap will be " "created - it is not packed into a .tgz once complete." msgstr "" #. type: textblock #: em_multistrap:609 msgid "As with debootstrap, em_multistrap will continue after errors." msgstr "" #. type: textblock #: em_multistrap:611 msgid "" "em_multistrap does not currently implement the machine:variant support used " "in Emdebian but the build directory is not packed up at the end of the run " "so other scripts can be used to implement customisations." msgstr "" #. type: =head1 #: em_multistrap:615 msgid "Secure Apt" msgstr "" #. type: textblock #: em_multistrap:617 msgid "" "To use authenticated apt repositories, multistrap either needs to be able to " "install an appropriate keyring package from the existing apt sources " "*outside the multistrap environment* or have the relevant keys already " "configured using apt-key *on the host system*." msgstr "" #. type: textblock #: em_multistrap:622 msgid "" "If relevant packages exist, specify them in the 'keyring' option for each " "repository. em_multistrap will then check that apt has already installed " "this package so that the repository can be authenticated before any packages " "are downloaded from it." msgstr "" #. type: textblock #: em_multistrap:627 msgid "" "Note that *all* repositories to be used with multistrap must be " "authenticated or apt will fail. Similarly, secure apt can only be disabled " "for all repositories (by using the --no-auth command line option or setting " "the general noauth option in the configuration file), even if only one " "repository does not have a suitable keyring available. Not all packages need " "keyring packages, if you configure apt-key appropriately." msgstr "" #. type: textblock #: em_multistrap:635 msgid "" "The keyring package(s) will also be installed inside the multistrap " "environment to match the installed apt sources for the multistrap." msgstr "" #. type: textblock #: em_multistrap:638 msgid "" "All configuration of apt-key needs to be done for the machine running " "multistrap itself." msgstr "" #. type: =head1 #: em_multistrap:641 msgid "State" msgstr "" #. type: textblock #: em_multistrap:643 msgid "" "multistrap is stateless - if the directory exists, it will simply proceed as " "normal and apt will try to pick up where it left off." msgstr "" #. type: =head1 #: em_multistrap:646 msgid "Native mode - multistrap" msgstr "" #. type: textblock #: em_multistrap:648 msgid "" "em_multistrap was not intended for native support, it was developed for " "cross architecture support. In order for multiple repositories to be used, " "em_multistrap only unpacks the packages selected by apt." msgstr "" #. type: textblock #: em_multistrap:652 msgid "" "In native mode, various post-multistrap operations are likely to be needed " "that debootstrap would do for you:" msgstr "" #. type: verbatim #: em_multistrap:655 #, no-wrap msgid "" " 1. copy /etc/hosts into the chroot\n" " 2. clean the environment to unset LANGUAGE, LC_ALL and LANG\n" " to silence nuisance perl warnings that obscure other errors\n" "\n" msgstr "" #. type: textblock #: em_multistrap:659 msgid "" "(An alternative to unset the localisation variables is to add locales to " "your multistrap configuration file in the 'packages' option." msgstr "" #. type: textblock #: em_multistrap:663 msgid "" "Eventually, multistrap will either replace em_multistrap or call " "em_multistrap with --arch and take over native duties." msgstr ""
Attachment:
pgpO6fEW9Wu4W.pgp
Description: PGP signature