|
|
|
### Basic Usage:
|
|
|
|
|
|
1. Open terminal emulator
|
|
1. Open terminal emulator
|
|
2. Type `su` to obtain root
|
|
1. Type `su` to obtain root
|
|
3. Type `onandroid`
|
|
1. Type `onandroid`
|
|
4. Wait and watch
|
|
1. Wait and watch
|
|
|
|
|
|
**Custom Backup Name**
|
|
The behaviour of Online Nandroid can be adjusted by using command line flags, some of which are described in detail below. Each command line flag has its longer counter-part and both forms can be mixed. For a complete list of command line flags and short descriptions, you can type:
|
|
* Example:
|
|
```shell
|
|
`onandroid custom_name`
|
|
onandroid -h
|
|
|
|
OR
|
|
|
|
onandroid --help
|
|
|
|
```
|
|
|
|
|
|
|
|
<br />
|
|
|
|
<br />
|
|
|
|
|
|
|
|
### Custom Backup Name:
|
|
|
|
* Example:
|
|
|
|
```shell
|
|
|
|
onandroid -c NAME
|
|
|
|
OR
|
|
|
|
onandroid --custom NAME
|
|
|
|
```
|
|
* Please be careful not to include characters not allowed in filenames.
|
|
* Please be careful not to include characters not allowed in filenames.
|
|
|
|
|
|
**Timezone modifier**
|
|
<br />
|
|
* Example: Use home/phone timezone for backup file name
|
|
<br />
|
|
`onandroid -h`
|
|
|
|
|
|
|
|
|
|
### Timezone modifier:
|
|
|
|
* Example: Use phone timezone for backup file name
|
|
|
|
```shell
|
|
|
|
onandroid -p
|
|
|
|
OR
|
|
|
|
onandroid --phone
|
|
|
|
```
|
|
* Example: Use UTC (default) for backup file name
|
|
* Example: Use UTC (default) for backup file name
|
|
`onandroid -u`
|
|
```shell
|
|
|
|
onandroid -u
|
|
|
|
OR
|
|
|
|
onandroid --utc
|
|
|
|
```
|
|
* Note: UTC is used as default (if no timezone modifier is passed). This is to comply with CWM nandroid backups.
|
|
* Note: UTC is used as default (if no timezone modifier is passed). This is to comply with CWM nandroid backups.
|
|
|
|
|
|
|
|
<br />
|
|
|
|
<br />
|
|
|
|
|
|
|
|
### Backup Modes:
|
|
|
|
###### Good old backup mode (default).
|
|
|
|
Example:
|
|
|
|
```shell
|
|
|
|
onandroid -o
|
|
|
|
OR
|
|
|
|
onandroid --old
|
|
|
|
```
|
|
|
|
* Note: This is the most commonly known, default backup format.
|
|
|
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
##### Split backup mode (CWM6+ only).
|
|
|
|
Example:
|
|
|
|
```shell
|
|
|
|
onandroid -l
|
|
|
|
OR
|
|
|
|
onandroid --split
|
|
|
|
```
|
|
|
|
* Note: This is specifically useful if you have partitions which are over 2GB in size. Use this only if you have CWM 6+.
|
|
|
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
##### CWM6 style incremental / dedupe backup mode.
|
|
|
|
Example:
|
|
|
|
```shell
|
|
|
|
onandroid -i
|
|
|
|
OR
|
|
|
|
onandroid --incremental
|
|
|
|
```
|
|
|
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
##### Garbage collect. For incremental backups (used for cleanup after deleting incremental backups).
|
|
|
|
Example:
|
|
|
|
```shell
|
|
|
|
onandroid -gc
|
|
|
|
OR
|
|
|
|
onandroid --garbagecollect
|
|
|
|
```
|
|
|
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
##### Advanced / Selective backup mode. For backing up only specific partitions.
|
|
|
|
Example:
|
|
|
|
```shell
|
|
|
|
onandroid -a PARTITIONS
|
|
|
|
OR
|
|
|
|
onandroid --advanced PARTITIONS
|
|
|
|
```
|
|
|
|
* Partition letters / names can be found by typing [B]onandroid -ah[/B]
|
|
|
|
|
|
|
|
<br />
|
|
|
|
<br />
|
|
|
|
|
|
|
|
### Replace Older Backups (with same name) - used with custom backup names:
|
|
|
|
* While using custom backup names, Online Nandroid will not allow an already existing backup name to be specified, by default. Trying this will return an error and halt backup. If you want to replace the older backup with a new backup, by using the same custom backup name, you can specify the below command line flag.
|
|
|
|
* Example:
|
|
|
|
```shell
|
|
|
|
onandroid -c MyBackup -r
|
|
|
|
OR
|
|
|
|
onandroid --custom MyBackup --replace
|
|
|
|
```
|
|
|
|
* Note: This will only work with custom backup names and is not a true replace per se. Online Nandroid will first delete the old backup folder and create a new folder. Thus, if backup halts in the middle of it, for whatever reason, the backup may not be usable at all. So be careful about this flag. |
|
|
|
\ No newline at end of file |