From patchwork Wed Feb 28 05:43:16 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Joel Stanley X-Patchwork-Id: 878935 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [103.22.144.68]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3zrkxx0cd3z9s37 for ; Wed, 28 Feb 2018 16:43:33 +1100 (AEDT) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=jms.id.au Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="Dc+Sv2yk"; dkim-atps=neutral Received: from bilbo.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 3zrkxw5XdczF1X8 for ; Wed, 28 Feb 2018 16:43:32 +1100 (AEDT) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=jms.id.au Authentication-Results: lists.ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="Dc+Sv2yk"; dkim-atps=neutral X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=gmail.com (client-ip=2607:f8b0:400e:c00::241; helo=mail-pf0-x241.google.com; envelope-from=joel.stan@gmail.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=jms.id.au Authentication-Results: lists.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="Dc+Sv2yk"; dkim-atps=neutral Received: from mail-pf0-x241.google.com (mail-pf0-x241.google.com [IPv6:2607:f8b0:400e:c00::241]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 3zrkxq0bFvzF1Wl for ; Wed, 28 Feb 2018 16:43:26 +1100 (AEDT) Received: by mail-pf0-x241.google.com with SMTP id z10so591537pfh.13 for ; Tue, 27 Feb 2018 21:43:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:subject:date:message-id; bh=yq/CtaYuKCxk+MphUeuShjahq541F1kpHo1J0CvDwNk=; b=Dc+Sv2yk67OjrQCAI9sMp8gHfhmsbBX8esUk+4V3uICMExD+gJrzYPsFIU3W3+tC+r +WtpC9P1k1IuHhrspomLvjyqaKBScuL2lj9CQv7FYZWeHsdvPieZrzU2V1xazGU5/JUc J2vP7bVMgmawLXBDZyOclOcD4um5+UD3e0fUecFMEPbQpaKDQc7d+y7egr8gYD4Tb0dc 6WqSqj3yBWkBXCwo2fesfknTS67hmH8czaVb7+qF29kZ23I8Ezais8TK2OSm9oVzk8JE GjLV535SC2u63SEbwf8qou/hchGtX4svzVTAbJtHigU15bR7BMTFrdJ5SZey037KUxcV 2S1Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:subject:date:message-id; bh=yq/CtaYuKCxk+MphUeuShjahq541F1kpHo1J0CvDwNk=; b=IlETGvqKf0LYTb8OS8eFv9hV20F4Qbrvnu3Kq6dDI+xgIMCFxnD5ICkT9H2AqdmU2i 9HwxmJkiCCDpI9pSk82MEJDEz41b6c/3qDm3wh835CmqUqa+Y5lJti87TYq7lvp9Jqp4 /Yn3TQNI29kT+aMNAmvldV+F6qFMt0J4Rlsrgw7MxdIwucVV+4V8G+8CqoFqi8T+ESoG 9/v+whm6NIqpVhQ2sVCFe0aiaFtfirLhFo4zD39HzJIbZZI98WM64OpMKAAeM3P13Pal 0f5uvYJeeecGW0JnrmyA6GwcX2F10bzKn+rLsIjJChUXYqrK8dgkG7+8T+vnsHEH8zgW KB2g== X-Gm-Message-State: APf1xPAJAG+J/JpoQfyYFVcXbwT5YbezUxrLyNdIgQ8aAywXLUx9CwdZ 1Lc4hZwMUjIEuoeUeVJgxqt/xMzN X-Google-Smtp-Source: AH8x225wHyH76kyxq2BZk8+lDlfDa25i0verGZG4Mr5FF/EknB2E+ugZHpTWsk1Ij1VITCCnD7HPLg== X-Received: by 10.101.73.141 with SMTP id r13mr13265115pgs.161.1519796603890; Tue, 27 Feb 2018 21:43:23 -0800 (PST) Received: from aurora.jms.id.au ([203.0.153.9]) by smtp.gmail.com with ESMTPSA id q22sm1452879pfk.138.2018.02.27.21.43.21 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 27 Feb 2018 21:43:23 -0800 (PST) Received: by aurora.jms.id.au (sSMTP sendmail emulation); Wed, 28 Feb 2018 16:13:18 +1030 From: Joel Stanley To: skiboot@lists.ozlabs.org Date: Wed, 28 Feb 2018 16:13:16 +1030 Message-Id: <20180228054316.27480-1-joel@jms.id.au> X-Mailer: git-send-email 2.15.1 Subject: [Skiboot] [PATCH] README: document output files X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" A grumpy BMC developer was wondering which file to flash to the machines they were testing on. They longed for the old days where the answer was 'skiboot.lid'. Alas, those days are long past. This updates the readme with a list of the current output formats and where you might want to use them. Signed-off-by: Joel Stanley --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 8d4d9a37aed1..62f924cb6abe 100644 --- a/README.md +++ b/README.md @@ -123,6 +123,25 @@ You probably want to read the linux https://kernel.org/doc/html/latest/process/submitting-patches.html as much of it applies to skiboot. + +## Output files + +The Skiboot build process produces a bunch of different outputs. This is what +they are, and where you should use them: + + skiboot.elf: The output of the linker. Don't flash to a system, but useful when debugging + + skiboot.lid: The raw binary object, named .lid because IBM. Flash this on + really old P8 systems, the POWER Functional Simulator (mambo), or + FSP systems + + skiboot.lid.stb: Lid wrapped with secure boot header. Use on FSP systems + + skiboot.lid.xz: Compressed raw binary. Use this on a OpenPower P8 + + skiboot.lid.xz.stb: Compressed raw binary wrapped with a secure boot header. + Use this on OpenPower P8 systems + ## License See LICENSE