From patchwork Sun Nov 11 13:15:01 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Martin X-Patchwork-Id: 198282 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from hemlock.osuosl.org (hemlock.osuosl.org [140.211.166.133]) by ozlabs.org (Postfix) with ESMTP id DA7772C008F for ; Mon, 12 Nov 2012 00:18:04 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id BD98FA01D1; Sun, 11 Nov 2012 13:18:03 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id VM67pbC89bUP; Sun, 11 Nov 2012 13:18:01 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by hemlock.osuosl.org (Postfix) with ESMTP id 9C55EA0172; Sun, 11 Nov 2012 13:17:05 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from whitealder.osuosl.org (whitealder.osuosl.org [140.211.166.138]) by ash.osuosl.org (Postfix) with ESMTP id 7127D8F753 for ; Sun, 11 Nov 2012 13:16:00 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 41DD18C2D7 for ; Sun, 11 Nov 2012 13:15:56 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LfAKRXBHz97v for ; Sun, 11 Nov 2012 13:15:54 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wi0-f175.google.com (mail-wi0-f175.google.com [209.85.212.175]) by whitealder.osuosl.org (Postfix) with ESMTPS id 45CFE8C2A6 for ; Sun, 11 Nov 2012 13:15:54 +0000 (UTC) Received: by mail-wi0-f175.google.com with SMTP id hq4so1316473wib.10 for ; Sun, 11 Nov 2012 05:15:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references; bh=AUfJMCGGF6IFmRdKH4t/DVlKu5NQ4t1I7x562alR5mA=; b=bAbTEWTQaa6kEw9tXNNAxG+psDaMuXSdnBD1Pj8nv49w0prH4glzhxnxJLZu0v9Vf9 5t5W06AHm6hxedAt7tOAZTvmeG4Yp3Yi0w2OaHFy11Ev3oC5yKe+VsaoNWRxq8fhAH/m j60ziRiPLtjlsPCfxEd9R9XMvKPU92fLRgTtrE1G57G8zqUgQaWwk+h96RiB1t6FHA8s h7yAGXh3MLcoktiNJ4zXiaudIksebn0xBkJT1PgRH2gHEQDAaymL0apaFx6G7IrYb/Co uIC963L6gkx5LoGqQkkvkvyfsjifmxmTXLUj+dWhzToICvWmELAow3VQzMbC4rYNgyxZ 9+Pg== Received: by 10.216.54.149 with SMTP id i21mr6733119wec.162.1352639753969; Sun, 11 Nov 2012 05:15:53 -0800 (PST) Received: from localhost.localdomain (ivr94-4-82-229-165-48.fbx.proxad.net. [82.229.165.48]) by mx.google.com with ESMTPS id hv4sm10262550wib.0.2012.11.11.05.15.52 (version=SSLv3 cipher=OTHER); Sun, 11 Nov 2012 05:15:53 -0800 (PST) From: Samuel Martin To: buildroot@busybox.net Date: Sun, 11 Nov 2012 14:15:01 +0100 Message-Id: <1352639701-27829-24-git-send-email-s.martin49@gmail.com> X-Mailer: git-send-email 1.8.0 In-Reply-To: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> References: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> Subject: [Buildroot] [PATCH 23/23] manual: add beyond-buildroot.txt X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: buildroot-bounces@busybox.net Signed-off-by: Samuel Martin create mode 100644 docs/manual/beyond-buildroot.txt diff --git a/docs/manual/beyond-buildroot.txt b/docs/manual/beyond-buildroot.txt new file mode 100644 index 0000000..12ce78c --- /dev/null +++ b/docs/manual/beyond-buildroot.txt @@ -0,0 +1,38 @@ +// -*- mode:doc; -*- + +Beyond Buildroot +================ + +Boot the generated images +------------------------- + +NFS boot +~~~~~~~~ + +To achieve NFS-boot, enable _tar root filesystem_ in the _Filesystem +images_ menu. + +After complete build, just run the following commands to setup the +NFS-root directory: + +------------------- +sudo tar -xavf /path/to/output_dir/rootfs.tar -C /path/to/nfs_root_dir +------------------- + +Then, you can execute a NFS-boot from your target. + +Chroot +------ + +If you want to chroot in a generated image, then there are few thing +you should be aware of: + +* you should setup the new root from the _tar root filesystem_ image; + +* either the selected target architecture is compatible with your host + machine, or you should use some +qemu-*+ binary and correctly set it + within the +binfmt+ properties to be able to run the binaries built + for the target on your host machine; + +* Buildroot does not currently provide +host-qemu+ and +binfmt+ + correctly built and set for that kind of use. diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt index a1ee68a..c34e0ca 100644 --- a/docs/manual/manual.txt +++ b/docs/manual/manual.txt @@ -25,6 +25,8 @@ include::developer-guide.txt[] include::legal-notice.txt[] +include::beyond-buildroot.txt[] + include::get-involved.txt[] include::contribute.txt[]