Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8)

This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e

2023-03-01 11:19:04 +00:00

3.4 KiB

Raw Blame History

Reclaim Disk Space

You can free up and reclaim disk space taken by previous updates once a newer version of an update has been committed to the system.

Run the query-dependencies command to show a list of updates that are required by the specified update (patch), including itself.
```
sw-patch query-dependences [ --recursive ] <patch-id>
```
The query-dependencies command will show a list of updates that are required by the specified update (including itself). The --recursive option will crawl through those dependencies to return a list of all the updates in the specified update's dependency tree. This query is used by the commit command in calculating the set of updates to be committed. For example,

controller-0:/home/sysadmin# sw-patch query-dependencies --PATCH_0004 --PATCH_0002 --PATCH_0003 --PATCH_0004

controller-0:/home/sysadmin# sw-patch query-dependencies --PATCH_0004 --recursive --PATCH_0001 --PATCH_0002 --PATCH_0003 --PATCH_0004
Run the sw-patch commit command.
```
sw-patch commit [ --dry-run ] [ --all ] [ --release ] [ <patch-id> … ]
```
The sw-patch commit command allows you to specify a set of updates to be committed. The commit set is calculated by querying the dependencies of each specified update.

The --all option, without the --release option, commits all updates of the currently running release. When two releases are on the system use the --release option to specify a particular release's updates if committing all updates for the non-running release. The --dry-run option shows the list of updates to be committed and how much disk space will be freed up. This information is also shown without the --dry-run option, before prompting to continue with the operation. An update can only be committed once it has been fully applied to the system, and cannot be removed after.

Following are examples that show the command usage.

The following command lists the status of all updates that are in an Applied state.
```
controller-0:/home/sysadmin# sw-patch query
```
The following command commits the updates.

controller-0:/home/sysadmin# sw-patch commit -PATCH_0001 -PATCH_0002 The following patches will be committed: -PATCH_0001 -PATCH_0002

This commit operation would free 2186.31 MiB

WARNING: Committing a patch is an irreversible operation. Committed patches

cannot be removed.

Would you like to continue? [y/N]: y The patches have been committed.

The following command shows the updates now in the Committed state.

controller-0:/home/sysadmin# sw-patch query Patch ID RR Release Patch State ================ ===== ======== ========= -PATCH_0001 N Committed -PATCH_0002 Y Committed

3.4 KiB Raw Blame History

Reclaim Disk Space

3.4 KiB

Raw Blame History