mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2025-06-25 07:00:45 -04:00
basics and customization fenced blocks replaced with standard markdown
This commit is contained in:
parent
cbdd6e00ab
commit
b65aa75876
4 changed files with 33 additions and 57 deletions
|
@ -55,15 +55,11 @@ By default, each domain's menu contains only a few shortcuts. If you'd like to a
|
||||||
|
|
||||||
To start apps from the console in dom0, type:
|
To start apps from the console in dom0, type:
|
||||||
|
|
||||||
```
|
qvm-run -a <domain> "<app name> [arguments]"
|
||||||
qvm-run -a <domain> "<app name> [arguments]"
|
|
||||||
```
|
|
||||||
|
|
||||||
e.g.:
|
e.g.:
|
||||||
|
|
||||||
```
|
qvm-run -a untrusted firefox
|
||||||
qvm-run -a untrusted firefox
|
|
||||||
```
|
|
||||||
|
|
||||||
Adding, Removing, and Listing Domains
|
Adding, Removing, and Listing Domains
|
||||||
-------------------------------------
|
-------------------------------------
|
||||||
|
@ -96,27 +92,23 @@ To allow domains to enter full screen mode, one should edit the `/etc/qubes/guid
|
||||||
|
|
||||||
E.g. to allow all domains to enter full screen mode, set `allow_fullscreen` flag to `true` in the `global` section:
|
E.g. to allow all domains to enter full screen mode, set `allow_fullscreen` flag to `true` in the `global` section:
|
||||||
|
|
||||||
```
|
global: {
|
||||||
global: {
|
|
||||||
# default values
|
# default values
|
||||||
allow_fullscreen = false;
|
allow_fullscreen = false;
|
||||||
#allow_utf8_titles = false;
|
#allow_utf8_titles = false;
|
||||||
#secure_copy_sequence = "Ctrl-Shift-c";
|
#secure_copy_sequence = "Ctrl-Shift-c";
|
||||||
#secure_paste_sequence = "Ctrl-Shift-v";
|
#secure_paste_sequence = "Ctrl-Shift-v";
|
||||||
#windows_count_limit = 500;
|
#windows_count_limit = 500;
|
||||||
};
|
};
|
||||||
```
|
|
||||||
|
|
||||||
To allow only select AppVMs to enter full screen mode, create a per-VM section, and set `allow_fullscreen` flag there to `true`:
|
To allow only select AppVMs to enter full screen mode, create a per-VM section, and set `allow_fullscreen` flag there to `true`:
|
||||||
|
|
||||||
```
|
VM: {
|
||||||
VM: {
|
|
||||||
work: {
|
work: {
|
||||||
allow_fullscreen = true;
|
allow_fullscreen = true;
|
||||||
};
|
};
|
||||||
|
|
||||||
};
|
};
|
||||||
```
|
|
||||||
|
|
||||||
In order for the changes to take effect, restart the AppVM(s).
|
In order for the changes to take effect, restart the AppVM(s).
|
||||||
|
|
||||||
|
|
|
@ -219,11 +219,7 @@ or
|
||||||
|
|
||||||
1. Go to the sysfs (`/sys/bus/pci`), find the right device, detach it from the pciback driver and attach back to the original driver. Replace `<BDF>` with your device, for example `00:1c.2`:
|
1. Go to the sysfs (`/sys/bus/pci`), find the right device, detach it from the pciback driver and attach back to the original driver. Replace `<BDF>` with your device, for example `00:1c.2`:
|
||||||
|
|
||||||
```
|
|
||||||
echo 0000:<BDF> > /sys/bus/pci/drivers/pciback/unbind
|
echo 0000:<BDF> > /sys/bus/pci/drivers/pciback/unbind
|
||||||
MODALIAS=`cat /sys/bus/pci/devices/0000:<BDF>/modalias`
|
MODALIAS=`cat /sys/bus/pci/devices/0000:<BDF>/modalias`
|
||||||
MOD=`modprobe -R $MODALIAS | head -n 1`
|
MOD=`modprobe -R $MODALIAS | head -n 1`
|
||||||
echo <BDF> > /sys/bus/pci/drivers/$MOD/bind
|
echo <BDF> > /sys/bus/pci/drivers/$MOD/bind
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -14,21 +14,20 @@ You may want to use a non-default template as a basis for Disposable VM. One exa
|
||||||
|
|
||||||
In order to regenerate the Disposable VM "snapshot" (called 'savefile' on Qubes) one can use the following command in Dom0:
|
In order to regenerate the Disposable VM "snapshot" (called 'savefile' on Qubes) one can use the following command in Dom0:
|
||||||
|
|
||||||
```
|
[joanna@dom0 ~]$ qvm-create-default-dvm <custom-template-name>
|
||||||
[joanna@dom0 ~]$ qvm-create-default-dvm <custom-template-name>
|
|
||||||
```
|
|
||||||
|
|
||||||
This would create a new Disposable VM savefile based on the custom template. Now, whenever one opens a file (from any AppVM) in a Disposable VM, a Disposable VM based on this template will be used.
|
This would create a new Disposable VM savefile based on the custom template. Now, whenever one opens a file (from any AppVM) in a Disposable VM, a Disposable VM based on this template will be used.
|
||||||
|
|
||||||
One can easily verify if the new Disposable VM template is indeed based on a custom template (in the example below the template called "f17-yellow" was used as a basis for the Disposable VM):
|
One can easily verify if the new Disposable VM template is indeed based on a custom template (in the example below the template called "f17-yellow" was used as a basis for the Disposable VM):
|
||||||
|
|
||||||
```
|
|
||||||
[joanna@dom0 ~]$ ll /var/lib/qubes/dvmdata/
|
[joanna@dom0 ~]$ ll /var/lib/qubes/dvmdata/
|
||||||
total 0
|
total 0
|
||||||
lrwxrwxrwx 1 joanna joanna 45 Mar 11 13:59 default_dvm.conf -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm.conf
|
lrwxrwxrwx 1 joanna joanna 45 Mar 11 13:59 default_dvm.conf -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm.conf
|
||||||
lrwxrwxrwx 1 joanna joanna 49 Mar 11 13:59 default_savefile -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm-savefile
|
lrwxrwxrwx 1 joanna joanna 49 Mar 11 13:59 default_savefile -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm-savefile
|
||||||
lrwxrwxrwx 1 joanna joanna 47 Mar 11 13:59 savefile_root -> /var/lib/qubes/vm-templates/f17-yellow/root.img
|
lrwxrwxrwx 1 joanna joanna 47 Mar 11 13:59 savefile_root -> /var/lib/qubes/vm-templates/f17-yellow/root.img
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
Customization of Disposable VM
|
Customization of Disposable VM
|
||||||
|
@ -38,9 +37,8 @@ It is possible to change the settings of each new Disposable VM (DispVM). This c
|
||||||
|
|
||||||
1. Start a terminal in the `fedora-20-x64-dvm` TemplateVM by running the following command in a dom0 terminal. (By default, this TemplateVM is not shown in Qubes VM Manager. However, it can be shown by selecting "Show/Hide internal VMs.")
|
1. Start a terminal in the `fedora-20-x64-dvm` TemplateVM by running the following command in a dom0 terminal. (By default, this TemplateVM is not shown in Qubes VM Manager. However, it can be shown by selecting "Show/Hide internal VMs.")
|
||||||
|
|
||||||
```
|
|
||||||
[user@dom0 ~]$ qvm-run -a fedora-20-x64-dvm gnome-terminal
|
[user@dom0 ~]$ qvm-run -a fedora-20-x64-dvm gnome-terminal
|
||||||
```
|
|
||||||
|
|
||||||
2. Change the VM's settings and/or applications, as desired. Note that currently Qubes supports exactly one DispVM template, so any changes you make here will affect all DispVMs. Some examples of changes you may want to make include:
|
2. Change the VM's settings and/or applications, as desired. Note that currently Qubes supports exactly one DispVM template, so any changes you make here will affect all DispVMs. Some examples of changes you may want to make include:
|
||||||
- Changing Firefox's default startup settings and homepage.
|
- Changing Firefox's default startup settings and homepage.
|
||||||
|
@ -49,15 +47,13 @@ It is possible to change the settings of each new Disposable VM (DispVM). This c
|
||||||
|
|
||||||
3. Create an empty `/home/user/.qubes-dispvm-customized` file:
|
3. Create an empty `/home/user/.qubes-dispvm-customized` file:
|
||||||
|
|
||||||
```
|
|
||||||
[user@fedora-20-x64-dvm ~]$ touch /home/user/.qubes-dispvm-customized
|
[user@fedora-20-x64-dvm ~]$ touch /home/user/.qubes-dispvm-customized
|
||||||
```
|
|
||||||
|
|
||||||
4. Shutdown the VM (either by `poweroff` from VM terminal, or `qvm-shutdown` from dom0 terminal).
|
4. Shutdown the VM (either by `poweroff` from VM terminal, or `qvm-shutdown` from dom0 terminal).
|
||||||
5. Regenerate the DispVM template:
|
5. Regenerate the DispVM template:
|
||||||
|
|
||||||
```
|
|
||||||
[user@dom0 ~]$ qvm-create-default-dvm --default-template --default-script
|
[user@dom0 ~]$ qvm-create-default-dvm --default-template --default-script
|
||||||
```
|
|
||||||
|
|
||||||
**Note:** All of the above requires at least qubes-core-vm \>= 2.1.2 installed in template.
|
**Note:** All of the above requires at least qubes-core-vm \>= 2.1.2 installed in template.
|
||||||
|
|
|
@ -18,15 +18,11 @@ Requirements (as of 10/24/2012):
|
||||||
|
|
||||||
Installation:
|
Installation:
|
||||||
|
|
||||||
```
|
qubes-dom0-update --enablerepo=qubes-dom0-unstable @XFCE
|
||||||
qubes-dom0-update --enablerepo=qubes-dom0-unstable @XFCE
|
|
||||||
```
|
|
||||||
|
|
||||||
Then you need to create /etc/sysconfig/desktop to stay with KDM, as GDM still starts invalid Xorg startup script:
|
Then you need to create /etc/sysconfig/desktop to stay with KDM, as GDM still starts invalid Xorg startup script:
|
||||||
|
|
||||||
```
|
DISPLAYMANAGER=KDE
|
||||||
DISPLAYMANAGER=KDE
|
|
||||||
```
|
|
||||||
|
|
||||||
Reboot the system. At system startup, select "Xfce session" in login screen (menu on the right bottom corner of the screen).
|
Reboot the system. At system startup, select "Xfce session" in login screen (menu on the right bottom corner of the screen).
|
||||||
|
|
||||||
|
@ -39,7 +35,6 @@ Things needs/recommended to be done:
|
||||||
- create own favorites menu (currently standard XFCE menu isn't modified to use per-VM subsections, which makes it very inconvenient):
|
- create own favorites menu (currently standard XFCE menu isn't modified to use per-VM subsections, which makes it very inconvenient):
|
||||||
1. create \~/.config/menus/favorites.menu, example content:
|
1. create \~/.config/menus/favorites.menu, example content:
|
||||||
|
|
||||||
```
|
|
||||||
<!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 1.0//EN"
|
<!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 1.0//EN"
|
||||||
"http://www.freedesktop.org/standards/menu-spec/1.0/menu.dtd">
|
"http://www.freedesktop.org/standards/menu-spec/1.0/menu.dtd">
|
||||||
|
|
||||||
|
@ -60,8 +55,5 @@ Things needs/recommended to be done:
|
||||||
<Filename>untrusted-firefox.desktop</Filename>
|
<Filename>untrusted-firefox.desktop</Filename>
|
||||||
</Include>
|
</Include>
|
||||||
</Menu>
|
</Menu>
|
||||||
```
|
|
||||||
|
|
||||||
2. add it to the panel: right click on panel, "add new items", select "XFCE menu", choose custom menu file - just created one
|
2. add it to the panel: right click on panel, "add new items", select "XFCE menu", choose custom menu file - just created one
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue