Skip to content

Commit 9b86bdb

Browse files
committed
Editing dump_restore.md
* replace passive voice with active * some sentence simplification * Use "For example" instead of "In other words" (vale rules) * other minor corrections
1 parent a38ddf7 commit 9b86bdb

File tree

1 file changed

+13
-14
lines changed

1 file changed

+13
-14
lines changed

docs/guides/backup/dump_restore.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: dump and restore command
33
author: tianci li
4-
contributors:
4+
contributors: Steven Spencer
55
tested_with: 8.10
66
tags:
77
- dump
@@ -11,7 +11,7 @@ tags:
1111

1212
## Overview
1313

14-
`dump` examines files in a filesystem, determines which ones need to be backed up, and copies those files to a specified disk, tape or other storage medium. The `restore` command performs the inverse function of `dump`.
14+
`dump` examines files in a filesystem, determines which to back up, and copies those files to a specified disk, tape or other storage medium. The `restore` command performs the inverse function of `dump`.
1515

1616
This utility is applicable to the following file systems:
1717

@@ -21,17 +21,17 @@ This utility is applicable to the following file systems:
2121

2222
!!! tip
2323

24-
For the xfs file system, please use `xfsdump`.
24+
For the xfs file system, use `xfsdump`.
2525

2626
[This](https://dump.sourceforge.io/) is the homepage of the project.
2727

28-
Before using this utility, please execute the following command to install it:
28+
Before using this utility, run the following command to install it:
2929

3030
```bash
3131
Shell > dnf -y install dump
3232
```
3333

34-
After installation, two commonly used command tools will be released:
34+
After installation, two commonly used command tools are available:
3535

3636
* `dump`
3737
* `restore`
@@ -47,11 +47,11 @@ Common options are:
4747

4848
* `-<level>` - Backup level. When in actual use, please replace "level" with any number from 0-9. The number 0 represents full backup, while other numbers represent incremental backup.
4949
* `-f <File-Name>` - Specify the file name and path after backup.
50-
* `-u` - After a successful backup, record the backup time in the **/etc/dumpdates** file. When the backed up object is an independent partition, you can use the `-u` option. However, when the backup object is a non-partitioned directory, the `-u` option cannot be used.
50+
* `-u` - After a successful backup, record the backup time in the **/etc/dumpdates** file. When the backed up object is an independent partition, you can use the `-u` option. However, when the backup object is a non-partitioned directory, you cannot use the `-u` option.
5151
* `-v` - Display the processing details during the backup process.
5252
* `-W` - An option for viewing dump information.
53-
* `-z[LEVEL]` - Adjust the compression level using the zlib library, with a default compression level of 2. In other words, you can compress the backup file to `.gz` format. The adjustable range of compression level is 1-9.
54-
* `-j[LEVEL]` - Adjust the compression level using the bzlib library, with a default compression level of 2. In other words, you can compress the backup file to `.bz2` format. The adjustable range of compression level is 1-9.
53+
* `-z[LEVEL]` - Adjust the compression level using the zlib library, with a default compression level of 2. For example, you can compress the backup file to `.gz` format. The adjustable range of compression level is 1-9.
54+
* `-j[LEVEL]` - Adjust the compression level using the bzlib library, with a default compression level of 2. For example, you can compress the backup file to `.bz2` format. The adjustable range of compression level is 1-9.
5555

5656
#### Example of using `dump`
5757

@@ -144,7 +144,7 @@ Common options are:
144144
/dev/nvme0n1p2 ( /) Last dump: Level 1, Date Sun Dec 8 19:38:51 2024
145145
```
146146

147-
4. For non-partitioned directory, only Full Backup (`-0`) can be used and the `-u` option cannot be used:
147+
4. For non-partitioned directory, you can only use the Full Backup (`-0`) option, not the `-u` option:
148148

149149
```bash
150150
Shell > dump -0uj -f /tmp/etc-full-20241208.bak.bz2 /etc/
@@ -191,16 +191,16 @@ The usage of this command is - `restore <mode(flag)> [option(s)] -f <Dump-File>`
191191
192192
The mode (flag) can be one of the following:
193193
194-
* `-C` - Comparison mode. Restore reads the backup and compares its contents with files present on the disk, it is mostly used for comparison after performing a backup on a partition In this mode, only changes based on the original data will be compared. If there is new data on the disk, it cannot be detected and compared.
194+
* `-C` - Comparison mode. Restore reads the backup and compares its contents with files present on the disk, it is mostly used for comparison after performing a backup on a partition In this mode, `restore` will only compare changes based on the original data. If there is new data on the disk, you cannot compare or detect it.
195195
* `-i` - Interactive mode. This mode allows interactive restoration of files from a dump.
196196
* `-t` - List mode. List what data is in the backup file.
197-
* `-r` - Restore (rebuild) mode. If it is a "Full Backup + Incremental Backup" method, it needs to be restored in chronological order.
197+
* `-r` - Restore (rebuild) mode. If it is a "Full Backup + Incremental Backup" method, restoring data will occur in chronological order.
198198
* `-x` - Extraction mode. Extract some or all files from the backup file.
199199
200200
#### Example of using `restore`
201201
202202
1. Restore data from /tmp/etc-full-20241208.bak.bz2 :
203-
203+
204204
```bash
205205
Shell > mkdir /tmp/data/
206206
@@ -214,7 +214,7 @@ The mode (flag) can be one of the following:
214214
-rw------- 1 root root 5107632 Dec 8 20:39 restoresymtable
215215
```
216216
217-
As you can see, a file named restoresymtable appears after a successful restore. This file is an important file that is relied upon for performing incremental backup system restore operations.
217+
As you can see, a file named `restoresymtable` shows up after a successful restore. This file is important. It is for incremental backup system restore operations.
218218
219219
2. Process backup files in Interactive mode:
220220
@@ -226,4 +226,3 @@ The mode (flag) can be one of the following:
226226
```
227227
228228
In this mode, you can type ++question++ to view the available interactive commands.
229-

0 commit comments

Comments
 (0)