==== USBARCHIVE ====
----
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Create a backup on a remote machine
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^  ^  __Output Stack__  ^
|  |  **→**  |  |
|  //Level 1//  |  //→//  |  //Level 1//  | 

{{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}

|**Type**| [[manual:chapter5:basics#commands|Command]]  ||
|**Parallel list processing**| [[manual:chapter5:listproc#group-1commands-that-cannot-parallel-process|Group 1]]  || 
|**Affected by flags**|  [[manual:appendix:flags#flag-47|-47]] | Automatic reception and execution of data sent via USB  |
</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
The ''USBARCHIVE'' command sends through the USB connection a complete backup of the machine that issued the command. The format of the backup is identical to the one created by ''[[manual:chapter6:sdcard:cmd_sdarchive|SDARCHIVE]]''.

The receiving machine must have already issued a corresponding ''[[manual:chapter6:usb:cmd_usbrestore|USBRESTORE]]'' otherwise an error occurs. After the transmission has ended the receiving machine will reset itself and install the backup.
</callout>

<callout type="danger" icon="true" title="Compatibility">
----
This command is new in newRPL and does not exist in userRPL.
</callout>

<callout type="info" icon="true" title="Usage">
----
<code>
1:                              
……………………………………………………………………………………
USBARCHIVE
</code>
will result in the transmission of a complete backup of the calculator to the machine connected via USB cable, provided te other side is listening by means of ''[[manual:chapter6:usb:cmd_usbrestore|USBRESTORE]]''.
</callout>

<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
----
{{page>manual:chapter6:usb&nofooter&noeditbtn&inline}}
</callout>