> For the complete documentation index, see [llms.txt](https://theiotlearninginitiative.gitbook.io/ostro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://theiotlearninginitiative.gitbook.io/ostro/user-space/package-management-systems/swupd.md).

# SwUpd

## Software Update Mechanism for Ostro™ OS

> Ostro OS based software can be deployed to a target device in two ways:
>
> > Full Disk Flashing
> >
> > > A new software image is built and installed, completely replacing what was previously present on the device. It can be useful for initializing a device with Ostro OS. Software Update This is a component that Ostro OS borrows from Clear Linux\* OS and consists of both a server and client component. The Software Update component is not tied to any specific platform or architecture, as long as the concept of rootfs/filesystem is supported.

[Software Update Mechanism for Ostro™ OS](https://ostroproject.org/documentation/architecture/software-update.html)

## SwUpd

> The [SoftWare UPDater](https://clearlinux.org/features/software-update) — swupd — from [Clear Linux](https://clearlinux.org/) provides a new way of adding functionality to and updating a Linux-based OS. [Meta layer for swupd software-update](http://git.yoctoproject.org/cgit/cgit.cgi/meta-swupd/tree/docs/Guide.md)

* [About software update](https://clearlinux.org/documentation/swupdate_about_sw_update.html)
* [How to run the updater](https://clearlinux.org/documentation/swupdate_how_to_run_the_updater.html)
* ostro-image-noswupd (when building without swupd, the recommended mode for local image building)
* ostro-image-swupd   (when building with swupd, the recommended mode for deployment)

## Bundles

* [Bundles overview](https://clearlinux.org/documentation/bundles_overview.html)

![Clear Linux Bundles Overview](https://clearlinux.org/documentation/_images/bundles_overview.png)

```bash
root@edison:~# ls /usr/share/clear/bundles
os-core    world-dev
root@edison:~#
```

```bash
root@edison:~# swupd
Usage:
    swupd [OPTION...]
 or swupd [OPTION...] SUBCOMMAND [OPTION...]

Help Options:
   -h, --help              Show help options

Subcommands:
   bundle-add              Install a new bundle          
   bundle-remove           Uninstall a bundle            
   hashdump                Dumps the HMAC hash of a file 
   update                  Update to latest OS version   
   verify                  Verify content for OS version 
   check-update            Checks if a new OS version is available

To view subcommand options, run `swupd SUBCOMMAND --help'
root@edison:~#
```

```bash
root@edison:~# swupd update
swupd-client software update 2.87
   Copyright (C) 2012-2015 Intel Corporation
   bsdiff portions Copyright Colin Percival, see COPYING file for details

Error: Network issue, unable to proceed with update
Update exiting.
root@edison:~#
```

```bash
root@edison:~# swupd bundle-add editors
swupd-client bundle adder 2.87
   Copyright (C) 2012-2015 Intel Corporation
   bsdiff portions Copyright Colin Percival, see COPYING file for details

Cannot load official manifest MoM for version 4400
root@edison:~#
```

```bash
root@edison:~# swupd check-update -u example.com/updates
root@edison:~# swupd update -u example.com/updates
root@edison:~# swupd verify -u example.com/updates
```