Home

NOTE: swupd-server is no longer used in the Clear Linux Project, as all of its functionality has been ported to https://github.com/clearlinux/mixer-tools. As such, this documentation is in part out-of-date with respect to Clear Linux OS.

---

Overview

The swupd-server project provides a reference implementation of a software update server-side component that generates update content consumable by a software update client (swupd-client). Update content includes manifests that describe incremental changes in the OS from build to build, binary deltas, full copies of files (fullfiles) that were added/changed from a previous build, and packs composed of binary deltas and/or fullfiles.

Getting started

To see what is required to start using swupd-server, see the getting started guide.

Compiling the source

• Build-options

Format Bump HOWTO

SWUPD permits introduction of breaking changes into an OS update stream. For details see this page.

Signature creation

The swupd-client supports verification of a signed Manifest.MoM. Read more about enabling this signing mechanism.

Testing

• Functional-test-suite
• Coverage-report

Technical Implementation

• File-changes
• File-heuristics
• Hash-calculation
• Manifest-metadata
• Manifest-changes
• Manifest-structure
• Type-changes
• Web-content

Glossary

See Glossary.

Client Documentation

The client-side component of SWUPD lives in a separate repo, with documentation located here.

Reporting bugs

See Reporting-bugs.