From patchwork Sun Apr 11 16:44:33 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andreas Henriksson X-Patchwork-Id: 1464897 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::437; helo=mail-wr1-x437.google.com; envelope-from=swupdate+bncbch5pdgzrylbbe6pzsbqmgqeq7eihba@googlegroups.com; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20161025 header.b=eU3cQJ+P; dkim-atps=neutral Received: from mail-wr1-x437.google.com (mail-wr1-x437.google.com [IPv6:2a00:1450:4864:20::437]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4FJHm71dS9z9sVq for ; Mon, 12 Apr 2021 02:45:11 +1000 (AEST) Received: by mail-wr1-x437.google.com with SMTP id e9sf4945756wrg.6 for ; Sun, 11 Apr 2021 09:45:10 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1618159508; cv=pass; d=google.com; s=arc-20160816; b=iO2GvRZyq9N3ApX4tmeefRD1Ykh2Qr16o9AUsYKsA4Ot5hXK4Yg5KYPm+SJQkR0+vt IJJQ9SEL5hQkODydnD+y1LcJGalCQcYwBt/6u9l1akw7hbaTKkr3xYIgtEx88PfP5BvR LEPSYuG/BJMlBNm/KNaULODdVWmfd/JA2rMKu1hg1Nap1xxqL2W6XqSDKvwPRl9pPHzK VJud/2zE5f3wxspZlSrEJIAwuFhFcosluciYC3DprZ5/UeRxm0N5q7MstbCTR06hsnN5 JF3S5ArrNsZiJ4HAibSFG3d507+u9LCBCsaTNFtFxtV7CN94OKC60HLuZe0Ydrr+g4ur WN2g== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:mime-version:sender:dkim-signature; bh=60in2kSrzWUvkXz106dn3/2WxFgaSeZmpn9m6HKMwBY=; b=lCr87yZZudVNNJg5PKiKzSRjImX5Mi914EuywLStbugVI3fT2dQDe3nGTk1jVKokAX Tl6m5UFhH1OfeIQm8DfakNZBfjHVf0bzUNZGbJCvNe80qZ6k6w9rGQgg6upgL6uRiSVD mTWYgap0jbRUUNOaQG4AoE5uGtnKE1HkalmnZAk43+v/OLzflcWhitrt9GTZNMGf7YBt kTYKGiiKxTBTnkoh29HQwWARnHDF6oCVc8tuUd4B79T+ZVBLNWz+cIdj6L+yW/8f0fwt 1BoMeBQNeZcd0JzC8RMEHh8V6/jOnT2Nu5ATJgRhdxlp/NsX2pdqas4o/Lrp4xXnYBhf sIDg== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=neutral (google.com: 94.255.170.6 is neither permitted nor denied by best guess record for domain of ah@fatal.se) smtp.mailfrom=ah@fatal.se DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:mime-version:from:to:cc:subject:date:message-id:in-reply-to :references:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=60in2kSrzWUvkXz106dn3/2WxFgaSeZmpn9m6HKMwBY=; b=eU3cQJ+PbBeGYS8JZBtrCwK9ft44+gtdRFc9WWfN4w2YoWRndQRBF7ftDCo3enQUT9 V3R/3F3BRnAuFgvbLgwKYlCrv39YOt6icIBNpVfFwtywdPLkaaLBEIj2taIw3xEHKtSr K+rspGlC1Z6BAWEMFYAzZFFJfx1cYMCY8rQ9Iohy5KVfHcTEIsrbZr4GLlABbZx+7K9x 6bhS6wjD/4pgf7Zko9mpo5lsBp7imaAhDkiuMzYiukqMlRDVNx18uPIlPrq265lPFjn6 caqHFnl9iSnvjJCImIoEGzqWV/kJxWp7wt6jgb/HqDf9apIU6Gg3qrGLpH+CLBrqcSfe hbSw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:mime-version:from:to:cc:subject:date :message-id:in-reply-to:references:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=60in2kSrzWUvkXz106dn3/2WxFgaSeZmpn9m6HKMwBY=; b=TxHLwFfiA08Hgn5Cmc4QDRwVb7vFk6lDQI6/HuhfQwpAoBfgkljd1ZXD+JQHRqVMvE o3nN1me1jS8yVk6SuXdNTuMXMzWcarfWpb1BZ8AHWgGuXv7JcoyVNW2RUi75qjDTwBDF DX2Kae7UFb2uZTrR+NBpYhN+1mhEVSwtEYdZMdbpVD0Q/0JV6lH+VFVzM2Ud7nAAmKNi 3xTi1b5fMC23Y9G+YYecsBm0eGZ9HN4Ho7wzQT3lI/5WPYHG5GmYP1eoQLxF30WU+TJJ kW3tVWKUuKja7cp0lCiT7y4xiv41xSt+q8gpBmDBNEmYOeUrzheY+BtxgR8tRjrvI2jc S3bw== Sender: swupdate@googlegroups.com X-Gm-Message-State: AOAM533nxKc7ZKQettIJvGz4NZLnxsS18ktGNWV94BU+IsmDtgsWtcIO NukLTFVp25O3jb3ge2y9gbY= X-Google-Smtp-Source: ABdhPJw2Jv/W8V69aFCi6hEPGtNYCdzDpjBLwS/5to5B4vrW2Ef4NLsXOi+GdFUBsSlUSEWvesp0Ow== X-Received: by 2002:a1c:7315:: with SMTP id d21mr23350405wmb.155.1618159508085; Sun, 11 Apr 2021 09:45:08 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: swupdate@googlegroups.com Received: by 2002:a05:600c:3544:: with SMTP id i4ls6706029wmq.2.canary-gmail; Sun, 11 Apr 2021 09:45:07 -0700 (PDT) X-Received: by 2002:a7b:cf38:: with SMTP id m24mr11576702wmg.148.1618159507374; Sun, 11 Apr 2021 09:45:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1618159507; cv=none; d=google.com; s=arc-20160816; b=hJmUx9i19jq/4xXk1DCyZdmPdF1gm7+ogo4+zcJ1xDYxQQ52jCG9zKZm5n8po9xO/Y GUuBNCH++1jMfbFTO3Aa/+tKNwWq7M5kxY8EII16QXlMD7hviri7N59+7Ya1WJ12UZ3b mrquza4yVM0ZFMlZy9pmaKCcQ2QB78uld0ogRytUvtnEVqf+qik5s6vMWTHY3V77hFgJ jEpaeH97Ifeo8pRY+DFGvuFpBa5UNQ9Dvm4E8TFKH/YhoMXoRstL1vzjBluOE7wJZ9cS XcJKAow5f9NrDe4WgWY8rQTWfF0c1A5knITWepmrbjreubSPozH2YKLsYlgrblsLbCqV tbeg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=references:in-reply-to:message-id:date:subject:cc:to:from; bh=fJc16L8zbxwAVeJdf3yBLIkpZbymZ3j713/WEMrDNAg=; b=toDgMHKsecB7/nptZCn/nRurT+rg44YoU/D3hf20Gdm1Y6jyJT2BOTq/5ApQpvJcff TXXKS1JP0Y+OSjN7Mf5pbOuOh3S/eF1fIuIE9rL2LtEcv4bccY+1xaci20KNoosAMKkq tIsLsx8unyINvxaM6gRi+2JpIcsOasl3UWvjHemIJ8ai/2xN6vgawnT3U85HVotSC0Ks CGMWZyVFC+B54Cqfw9/VnaTc6QJDQRAJ6TC1M1dDd6WZQe206HnUuSwGl52UL1Sg92mV a3BPwTvzX3UJWICSZwSynYQGtYP8VrFLDUiAnAwykVFUGB0GkH/5Xo9yo9mhHNIyZcEy OWBA== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 94.255.170.6 is neither permitted nor denied by best guess record for domain of ah@fatal.se) smtp.mailfrom=ah@fatal.se Received: from pi.fatal.se (94-255-170-6.cust.bredband2.com. [94.255.170.6]) by gmr-mx.google.com with ESMTP id f8si1216827wmj.1.2021.04.11.09.45.07 for ; Sun, 11 Apr 2021 09:45:07 -0700 (PDT) Received-SPF: neutral (google.com: 94.255.170.6 is neither permitted nor denied by best guess record for domain of ah@fatal.se) client-ip=94.255.170.6; Received: by pi.fatal.se (Postfix, from userid 1000) id 992962769F; Sun, 11 Apr 2021 18:45:06 +0200 (CEST) From: Andreas Henriksson To: swupdate@googlegroups.com Cc: Andreas Henriksson Subject: [swupdate] [PATCH 2/4] docs: Add initial fw_env.config(5) manpage Date: Sun, 11 Apr 2021 18:44:33 +0200 Message-Id: <20210411164435.26361-3-andreas@fatal.se> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20210411164435.26361-1-andreas@fatal.se> References: <20210411164435.26361-1-andreas@fatal.se> X-Original-Sender: andreas@fatal.se X-Original-Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 94.255.170.6 is neither permitted nor denied by best guess record for domain of ah@fatal.se) smtp.mailfrom=ah@fatal.se Precedence: list Mailing-list: list swupdate@googlegroups.com; contact swupdate+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: swupdate@googlegroups.com X-Google-Group-Id: 605343134186 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Signed-off-by: Andreas Henriksson --- docs/fw_env.config.5.scd | 45 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/fw_env.config.5.scd diff --git a/docs/fw_env.config.5.scd b/docs/fw_env.config.5.scd new file mode 100644 index 0000000..389b365 --- /dev/null +++ b/docs/fw_env.config.5.scd @@ -0,0 +1,45 @@ +fw_env.config(5) "April 2021" "libubootenv" + +# SYNOPSIS + +*/etc/fw_env.config* + +# DESCRIPTION + +*fw_printenv* and *fw_setenv* expects a file that specifies where the +U-Boot environment lives, the offset and the size. + +The file can consist of one or two lines, depending on if it's +a traditionally or redundantly saved environment. + +If you use a traditional (non-redundant) environment the file *must* +contain one line. If you use a redundantly stored environment the +file *must* consist of two lines. +The traditional and redundant environments uses different on-disk formats +and are not interchangable. + +# SYNTAX + +``` + +[ ] +``` + +# EXAMPLES + +Non-redundant environment on MMC device: + +``` +/dev/mmcblk0 0x260000 0x2000 +``` + +Redundant environment on MMC device: + +``` +/dev/disk/by-path/platform-481d8000.mmc 0x260000 0x20000 +/dev/disk/by-path/platform-481d8000.mmc 0x300000 0x20000 +``` + +# SEE ALSO + +fw_printenv(1), fw_setenv(1)