From daa1a459971f45b2b44c13135c55457ab21eb8c9 Mon Sep 17 00:00:00 2001
From: Kevin Putnam <kevin.putnam@intel.com>
Date: Thu, 28 Jun 2018 13:28:43 -0700
Subject: [PATCH] first commit of swupd-guide.rst

---
 .../guides/maintenance/swupd_guide.rst        | 81 +++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 source/clear-linux/guides/maintenance/swupd_guide.rst

diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst
new file mode 100644
index 00000000..398ea209
--- /dev/null
+++ b/source/clear-linux/guides/maintenance/swupd_guide.rst
@@ -0,0 +1,81 @@
+.. _swupd_guide:
+
+swupd guide
+###########
+
+*swupd* manages the software update capability of |CLOSIA|. It can check for
+valid system updates and, if found, download and install them. It can also
+perform verification of the system software. 
+
+|CL| uses :ref:`bundles-about<bundles>` as the base abstraction for
+installing functionality on top of the core operating system. Use the `swupd`
+tool to install and remove bundles.
+
+.. contents:: 
+   :local:
+   :depth: 2
+
+For a full listing of commands and options please see the man page in |CL|
+
+.. code-block:: bash
+
+   man swupd
+
+OS Update and Verification
+**************************
+
+|CL| is designed to promote a regular update cadence. `swupd` helps to
+make sure that process is simple and secure.
+
+Automatic Updates
+=================
+
+|CL| updates can be toggled to happen automatically or on demand. Enable
+automatic updates like this:
+
+.. code-block:: bash
+
+   sudo swupd autoupdate --enable
+
+To disable use the `--disable` flag instead.
+
+System Software Verification
+============================
+
+`swupd` can determine whether the system software has been overwritten, removed, or modified in any way.
+
+.. code-block:: bash
+
+   sudo swupd verify
+
+Bundles
+*******
+
+Listing installed bundles
+=========================
+
+You can list all of the bundles currently installed on the system
+
+.. code-block:: bash
+
+   sudo swupd bundle-list --all 
+
+Adding a bundle
+===============
+
+Start by selecting a bundle from the list of :ref:`available-bundles`. In
+this example we're adding dev-utils-dev, which is useful for development.
+
+.. code-block:: bash
+
+   sudo swupd bundle-add dev-utils-dev
+
+Removing a bundle
+=================
+
+Dependencies common to other bundles will not be removed
+
+.. code-block:: bash
+
+   sudo swupd bundle-remove dev-utils-dev
+