Nessuna descrizione

Christoph Lauer b0b89d7d35 sign unencrypted sw-description 5 anni fa
classes b0b89d7d35 sign unencrypted sw-description 5 anni fa
conf efd819a9c6 Merge branch 'master' into thud 5 anni fa
recipes-bsp efd819a9c6 Merge branch 'master' into thud 5 anni fa
recipes-core 98650acaa4 initscripts-swupdate-usb: Mark init with update alternatives 5 anni fa
recipes-devtools 60a7f1e7bc Update mtd-utils to a version compatible wit SWUpdate 5 anni fa
recipes-extended 381c49b33a Enable cpio patch for later version 5 anni fa
recipes-lua 559b12c8f5 swupdate-lualoader: Add recipe 5 anni fa
recipes-support 9afb74d46b Revert "librsync: drop recipe" 5 anni fa
COPYING.MIT 020c327419 Receipes to generate a swupdate image 12 anni fa
README 9cc6781093 Allow expansion of BitBake variables in sw-description files 7 anni fa

README

meta-swupdate, Yocto layer for deploy tool
==========================================

This layer's purpose is to add support for a deployment
mechanism of Yocto's images based on swupdate project.

Layer dependencies
------------------

This layer depends on:

URI: git://github.com/openembedded/meta-openembedded.git
subdirectory: meta-oe

BitBake variable expansion
--------------------------

To insert the values of BitBake variables into the update file, pre- and postfix
the names with "@@". For example, to automatically set the version tag, use the
line `version = "@@DISTRO_VERSION@@";` in your sw-description file.

Image hashing
-------------

During creation of the update file, occurrences of @IMAGE (where IMAGE is an
image filename) are replaced with the sha256 hash of the image.

SWU image signing
------------

There are 3 signing mechanisms supported by meta-swupdate at the moment:

1. RSA signing:

* Set variable: `SWUPDATE_SIGNING = "RSA"`

* Set `SWUPDATE_PRIVATE_KEY` to the full path of private key file

2. CMS signing:

* Set variable: `SWUPDATE_SIGNING = "CMS"`

* Set `SWUPDATE_CMS_CERT` to the full path of certificate file

* Set `SWUPDATE_CMS_KEY ` to the full path of private key file

3. Custom signing tool:

* Set variable: `SWUPDATE_SIGNING = "CUSTOM"`

* Set variable `SWUPDATE_SIGN_TOOL' to custom string that needs to be
executed in order to perform the signing

sw-description is signed and the signature is written to sw-description.sig
which is included in the SWU file.

Encrypted private keys are not currently supported since a secure
mechanism must exist to provide the passphrase.

Maintainer
----------

Stefano Babic

Submitting patches
------------------

You can submit your patches (or post questions reagarding
this layer to the swupdate Mailing List:

swupdate@googlegroups.com

When creating patches, please use something like:

git format-patch -s --subject-prefix='meta-swupdate][PATCH'

Please use 'git send-email' to send the generated patches to the ML
to bypass changes from your mailer.