qubes-doc/common-tasks/copy-to-dom0.md

47 lines
2.2 KiB
Markdown
Raw Normal View History

2011-04-07 09:13:39 -04:00
---
2015-04-10 16:17:45 -04:00
layout: doc
title: Copying files to and from dom0
permalink: /doc/copy-to-dom0/
redirect_from:
- /en/doc/copy-to-dom0/
- /doc/CopyToDomZero/
- /wiki/CopyToDomZero/
2011-04-07 09:13:39 -04:00
---
Copying files to and from Dom0
2012-05-02 06:05:32 -04:00
-------------------------------------
There should normally be few reasons for the user to want to copy files from VMs to Dom0, as Dom0 only acts as a "thin trusted terminal", and no user applications run there. Copying untrusted files to Dom0 is not advised and may compromise the security of your Qubes system. Because of this, we do not provide a graphical user interface for it, unlike [copying files between VMs](/doc/copying-files/).
2012-05-02 06:05:32 -04:00
One common use-case for this is if we want to use a desktop wallpaper in Dom0 we have located in one of our AppVMs (e.g. in the 'personal' AppVM where we got the wallpaper from our camera or downloaded it from the Internet). While it's a well-justified reason, imagine what would happen if the wallpaper (e.g. a JPEG file) was somehow malformed or malicious and attempted to exploit a hypothetical JPEG parser bug in Dom0 code (e.g. in the Dom0's Xorg/KDE code that parses the wallpaper and displays it).
If you are determined to copy some files to Dom0 anyway, you can use the following method (run this command from Dom0's console):
2012-05-02 06:05:32 -04:00
~~~
2012-05-02 06:05:32 -04:00
qvm-run --pass-io <src_domain> 'cat /path/to/file_in_src_domain' > /path/to/file_name_in_dom0
~~~
2012-05-02 06:05:32 -04:00
You can use the same method to copy files from Dom0 to VMs:
2012-05-02 06:05:32 -04:00
~~~
2012-05-02 06:05:32 -04:00
cat /path/to/file_in_dom0 | qvm-run --pass-io <dst_domain> 'cat > /path/to/file_name_in_appvm'
~~~
### Copying logs from Dom0
In order to easily copy/paste the contents of logs from dom0 to the inter-VM clipboard, you can simply:
1. Right-click on the desired VM in the Qubes VM Manager.
2. Click "Logs."
3. Click on the desired log.
4. Click "Copy to Qubes clipboard."
You may now paste the log contents to any VM as you normally would (i.e., Ctrl-Shift-V, then Ctrl-V).
### Copy/Paste to and from Dom0
For data other than logs, there are two options:
1. Copy it as a file (see above)
2. Paste the data to `/var/run/qubes/qubes-clipboard.bin`, then write "dom0" to `/var/run/qubes/qubes-clipboard.bin.source`. Then use Ctrl-Shift-V to paste the data to the desired VM.