summaryrefslogtreecommitdiffstats
path: root/debian/manpages/VBoxSDL.1
blob: 754915c95f14ec9b180b68b6dd911786ccc5cc47 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH VBOXSDL "1" "April 2024" "VBoxSDL" "User Commands"
.SH NAME
VBoxSDL \- x86 virtualization solution
.SH DESCRIPTION
Oracle VM VirtualBox SDL GUI version 7.0.16
(C) 2005\-2024 Oracle Corporation
All rights reserved.
.SS "Usage:"
.TP
\fB\-\-startvm\fR <uuid|name>
Virtual machine to start, either UUID or name
.TP
\fB\-\-separate\fR
Run a separate VM process or attach to a running VM
.TP
\fB\-\-hda\fR <file>
Set temporary first hard disk to file
.TP
\fB\-\-fda\fR <file>
Set temporary first floppy disk to file
.TP
\fB\-\-cdrom\fR <file>
Set temporary CDROM/DVD to file/device ('none' to unmount)
.TP
\fB\-\-boot\fR <a|c|d|n>
Set temporary boot device (a = floppy, c = 1st HD, d = DVD, n = network)
.TP
\fB\-\-memory\fR <size>
Set temporary memory size in megabytes
.TP
\fB\-\-vram\fR <size>
Set temporary size of video memory in megabytes
.TP
\fB\-\-fullscreen\fR
Start VM in fullscreen mode
.TP
\fB\-\-fullscreenresize\fR
Resize the guest on fullscreen
.HP
\fB\-\-fixedmode\fR <w> <h> <bpp> Use a fixed SDL video mode with given width, height and bits per pixel
.TP
\fB\-\-nofstoggle\fR
Forbid switching to/from fullscreen mode
.TP
\fB\-\-noresize\fR
Make the SDL frame non resizable
.TP
\fB\-\-nohostkey\fR
Disable all hostkey combinations
.TP
\fB\-\-nohostkeys\fR ...
Disable specific hostkey combinations, see below for valid keys
.TP
\fB\-\-nograbonclick\fR
Disable mouse/keyboard grabbing on mouse click w/o additions
.TP
\fB\-\-detecthostkey\fR
Get the hostkey identifier and modifier state
.HP
\fB\-\-hostkey\fR <key> {<key2>} <mod> Set the host key to the values obtained using \fB\-\-detecthostkey\fR
.TP
\fB\-\-termacpi\fR
Send an ACPI power button event when closing the window
.TP
\fB\-\-vrdp\fR <ports>
Listen for VRDP connections on one of specified ports (default if not specified)
.TP
\fB\-\-discardstate\fR
Discard saved state (if present) and revert to last snapshot (if present)
.TP
\fB\-\-settingspw\fR <pw>
Specify the settings password
.TP
\fB\-\-settingspwfile\fR <file>
Specify a file containing the settings password
.TP
\fB\-\-securelabel\fR
Display a secure VM label at the top of the screen
.TP
\fB\-\-seclabelfnt\fR
TrueType (.ttf) font file for secure session label
.TP
\fB\-\-seclabelsiz\fR
Font point size for secure session label (default 12)
.TP
\fB\-\-seclabelofs\fR
Font offset within the secure label (default 0)
.TP
\fB\-\-seclabelfgcol\fR <rgb>
Secure label text color RGB value in 6 digit hexadecimal (eg: FFFF00)
.TP
\fB\-\-seclabelbgcol\fR <rgb>
Secure label background color RGB value in 6 digit hexadecimal (eg: FF0000)
.TP
\fB\-\-[no]rawr0\fR
Enable or disable raw ring 3
.TP
\fB\-\-[no]rawr3\fR
Enable or disable raw ring 0
.TP
\fB\-\-[no]patm\fR
Enable or disable PATM
.TP
\fB\-\-[no]csam\fR
Enable or disable CSAM
.TP
\fB\-\-[no]hwvirtex\fR
Permit or deny the usage of VT\-x/AMD\-V
.SS "Key bindings:"
.TP
<hostkey> +
f           Switch to full screen / restore to previous view
h           Press ACPI power button
n           Take a snapshot and continue execution
p           Pause / resume execution
q           Power off
r           VM reset
s           Save state and power off
.TP
<del>
Send <ctrl><alt><del>
.TP
<F1>...<F12>
Send <ctrl><alt><Fx>