# 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://theiotlearninginitiative.gitbook.io/ostro/user-space/package-management-systems/swupd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.