Changeset 106318 in vbox for trunk/doc/manual/en_US/dita
- Timestamp:
- Oct 15, 2024 5:55:25 AM (4 months ago)
- svn:sync-xref-src-repo-rev:
- 165126
- Location:
- trunk/doc/manual/en_US/dita
- Files:
-
- 4 edited
-
UserManual.ditamap (modified) (1 diff)
-
topics/create-optical-disk-image.dita (modified) (1 diff)
-
topics/efividmode.dita (modified) (1 diff)
-
topics/vrde-crypt.dita (modified) (5 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/doc/manual/en_US/dita/UserManual.ditamap
r106204 r106318 616 616 <topicref href="topics/secure-config-vms.dita"> 617 617 <topicref href="topics/security-networking.dita"/> 618 <topicref href="topics/security-of-remote-vms.dita"/> 618 619 <topicref href="topics/security-vrdp-auth.dita"/> 619 620 <topicref href="topics/security_clipboard.dita"/> -
trunk/doc/manual/en_US/dita/topics/create-optical-disk-image.dita
r105941 r106318 4 4 <title>Creating a Virtual Optical Disk Image</title> 5 5 <body> 6 <p>Use the <b outputclass="bold">VISO Creator</b> tool to create a virtual optical disk image . This enables you to7 create a virtual ISO from selected files on the host.</p>6 <p>Use the <b outputclass="bold">VISO Creator</b> tool to create a virtual optical disk image from selected files on the host. </p> 7 <p>A virtual ISO (VISO) differs from a real ISO because the files remain on the host, unless you choose to copy the files to the guest. This makes a VISO faster to create and use, and you do not need guest additions. A VISO is read-only and is ideal for use as installation media or reference data.</p> 8 8 <ol> 9 9 <li> -
trunk/doc/manual/en_US/dita/topics/efividmode.dita
r105289 r106318 5 5 6 6 <body> 7 <p>EFI provides two distinct video interfaces: GOP (Graphics Output Protocol) and UGA (Universal Graphics Adapter). 8 Modern OSes, such as Mac OS X, generally use GOP, while some older ones still use UGA. <ph 9 conkeyref="vbox-conkeyref-phrases/product-name"/> provides a configuration option to control the graphics 10 resolution for both interfaces, making the difference mostly irrelevant for users. </p> 7 <p>EFI provides two distinct video interfaces: GOP (Graphics Output Protocol) and UGA (Universal Graphics Adapter). Modern OSes, such as Mac OS X, generally use GOP, while some older ones still use UGA. <ph conkeyref="vbox-conkeyref-phrases/product-name"/> provides a configuration option to control the graphics resolution for both interfaces, making the difference mostly irrelevant for users.</p> 11 8 <p>The default resolution is 1024x768. To select a graphics resolution for EFI, use the following 12 9 <userinput>VBoxManage</userinput> command: </p> 13 10 <pre xml:space="preserve">VBoxManage setextradata "VM name" VBoxInternal2/EfiGraphicsResolution HxV</pre> 14 <p>Determine the horizontal resolution H and the vertical resolution V from the following list of default 15 resolutions: </p> 16 <dl> 17 <dlentry> 18 <dt> 19 VGA 20 </dt> 21 <dd> 22 <p> 23 640x480, 32bpp, 4:3 24 </p> 25 </dd> 26 </dlentry> 27 <dlentry> 28 <dt> 29 SVGA 30 </dt> 31 <dd> 32 <p> 33 800x600, 32bpp, 4:3 34 </p> 35 </dd> 36 </dlentry> 37 <dlentry> 38 <dt> 39 XGA 40 </dt> 41 <dd> 42 <p> 43 1024x768, 32bpp, 4:3 44 </p> 45 </dd> 46 </dlentry> 47 <dlentry> 48 <dt> 49 XGA+ 50 </dt> 51 <dd> 52 <p> 53 1152x864, 32bpp, 4:3 54 </p> 55 </dd> 56 </dlentry> 57 <dlentry> 58 <dt> 59 HD 60 </dt> 61 <dd> 62 <p> 63 1280x720, 32bpp, 16:9 64 </p> 65 </dd> 66 </dlentry> 67 <dlentry> 68 <dt> 69 WXGA 70 </dt> 71 <dd> 72 <p> 73 1280x800, 32bpp, 16:10 74 </p> 75 </dd> 76 </dlentry> 77 <dlentry> 78 <dt> 79 SXGA 80 </dt> 81 <dd> 82 <p> 83 1280x1024, 32bpp, 5:4 84 </p> 85 </dd> 86 </dlentry> 87 <dlentry> 88 <dt> 89 SXGA+ 90 </dt> 91 <dd> 92 <p> 93 1400x1050, 32bpp, 4:3 94 </p> 95 </dd> 96 </dlentry> 97 <dlentry> 98 <dt> 99 WXGA+ 100 </dt> 101 <dd> 102 <p> 103 1440x900, 32bpp, 16:10 104 </p> 105 </dd> 106 </dlentry> 107 <dlentry> 108 <dt> 109 HD+ 110 </dt> 111 <dd> 112 <p> 113 1600x900, 32bpp, 16:9 114 </p> 115 </dd> 116 </dlentry> 117 <dlentry> 118 <dt> 119 UXGA 120 </dt> 121 <dd> 122 <p> 123 1600x1200, 32bpp, 4:3 124 </p> 125 </dd> 126 </dlentry> 127 <dlentry> 128 <dt> 129 WSXGA+ 130 </dt> 131 <dd> 132 <p> 133 1680x1050, 32bpp, 16:10 134 </p> 135 </dd> 136 </dlentry> 137 <dlentry> 138 <dt> 139 Full HD 140 </dt> 141 <dd> 142 <p> 143 1920x1080, 32bpp, 16:9 144 </p> 145 </dd> 146 </dlentry> 147 <dlentry> 148 <dt> 149 WUXGA 150 </dt> 151 <dd> 152 <p> 153 1920x1200, 32bpp, 16:10 154 </p> 155 </dd> 156 </dlentry> 157 <dlentry> 158 <dt> 159 DCI 2K 160 </dt> 161 <dd> 162 <p> 163 2048x1080, 32bpp, 19:10 164 </p> 165 </dd> 166 </dlentry> 167 <dlentry> 168 <dt> 169 Full HD+ 170 </dt> 171 <dd> 172 <p> 173 2160x1440, 32bpp, 3:2 174 </p> 175 </dd> 176 </dlentry> 177 <dlentry> 178 <dt> 179 Unnamed 180 </dt> 181 <dd> 182 <p> 183 2304x1440, 32bpp, 16:10 184 </p> 185 </dd> 186 </dlentry> 187 <dlentry> 188 <dt> 189 QHD 190 </dt> 191 <dd> 192 <p> 193 2560x1440, 32bpp, 16:9 194 </p> 195 </dd> 196 </dlentry> 197 <dlentry> 198 <dt> 199 WQXGA 200 </dt> 201 <dd> 202 <p> 203 2560x1600, 32bpp, 16:10 204 </p> 205 </dd> 206 </dlentry> 207 <dlentry> 208 <dt> 209 QWXGA+ 210 </dt> 211 <dd> 212 <p> 213 2880x1800, 32bpp, 16:10 214 </p> 215 </dd> 216 </dlentry> 217 <dlentry> 218 <dt> 219 QHD+ 220 </dt> 221 <dd> 222 <p> 223 3200x1800, 32bpp, 16:9 224 </p> 225 </dd> 226 </dlentry> 227 <dlentry> 228 <dt> 229 WQSXGA 230 </dt> 231 <dd> 232 <p> 233 3200x2048, 32bpp, 16:10 234 </p> 235 </dd> 236 </dlentry> 237 <dlentry> 238 <dt> 239 4K UHD 240 </dt> 241 <dd> 242 <p> 243 3840x2160, 32bpp, 16:9 244 </p> 245 </dd> 246 </dlentry> 247 <dlentry> 248 <dt> 249 WQUXGA 250 </dt> 251 <dd> 252 <p> 253 3840x2400, 32bpp, 16:10 254 </p> 255 </dd> 256 </dlentry> 257 <dlentry> 258 <dt> 259 DCI 4K 260 </dt> 261 <dd> 262 <p> 263 4096x2160, 32bpp, 19:10 264 </p> 265 </dd> 266 </dlentry> 267 <dlentry> 268 <dt> 269 HXGA 270 </dt> 271 <dd> 272 <p> 273 4096x3072, 32bpp, 4:3 274 </p> 275 </dd> 276 </dlentry> 277 <dlentry> 278 <dt> 279 UHD+ 280 </dt> 281 <dd> 282 <p> 283 5120x2880, 32bpp, 16:9 284 </p> 285 </dd> 286 </dlentry> 287 <dlentry> 288 <dt> 289 WHXGA 290 </dt> 291 <dd> 292 <p> 293 5120x3200, 32bpp, 16:10 294 </p> 295 </dd> 296 </dlentry> 297 <dlentry> 298 <dt> 299 WHSXGA 300 </dt> 301 <dd> 302 <p> 303 6400x4096, 32bpp, 16:10 304 </p> 305 </dd> 306 </dlentry> 307 <dlentry> 308 <dt> 309 HUXGA 310 </dt> 311 <dd> 312 <p> 313 6400x4800, 32bpp, 4:3 314 </p> 315 </dd> 316 </dlentry> 317 <dlentry> 318 <dt> 319 8K UHD2 320 </dt> 321 <dd> 322 <p> 323 7680x4320, 32bpp, 16:9 324 </p> 325 </dd> 326 </dlentry> 327 </dl> 328 <p>If this list of default resolution does not cover your needs, see <xref href="customvesa.dita">Custom VESA 329 Resolutions</xref>. Note that the color depth value specified in a custom video mode must be specified. Color 330 depths of 8, 16, 24, and 32 are accepted. EFI assumes a color depth of 32 by default. </p> 11 <p>Find the horizontal resolution H and the vertical resolution V from the following list of default resolutions: <table frame="all" rowsep="1" colsep="1"> 12 <title>Default Resolutions for Display Types</title> 13 <desc>Common display types and their default resolution values.</desc> 14 <tgroup cols="5"> 15 <colspec colname="c1" colnum="1" colwidth="1*"/> 16 <colspec colname="c2" colnum="2" colwidth="1.52*"/> 17 <colspec colname="c3" colnum="3" colwidth="1.37*"/> 18 <colspec colname="newCol4" colnum="4" colwidth="1.14*"/> 19 <colspec colname="c4" colnum="5" colwidth="1.22*"/> 20 <thead> 21 <row> 22 <entry>Display Type</entry> 23 <entry>Default Horizontal Resolution (px)</entry> 24 <entry>Default Vertical Resolution (px)</entry> 25 <entry>Color Depth (BPP)</entry> 26 <entry>Display Aspect Ratio</entry> 27 </row> 28 </thead> 29 <tbody> 30 <row> 31 <entry><b>VGA</b></entry> 32 <entry>640</entry> 33 <entry>480</entry> 34 <entry>32</entry> 35 <entry>4:3</entry> 36 </row> 37 <row> 38 <entry><b>SVGA</b></entry> 39 <entry>800</entry> 40 <entry>600</entry> 41 <entry>32</entry> 42 <entry>4:3</entry> 43 </row> 44 <row> 45 <entry><b>XGA</b></entry> 46 <entry>1024</entry> 47 <entry>768</entry> 48 <entry>32</entry> 49 <entry>4:3</entry> 50 </row> 51 <row> 52 <entry><b>XGA+</b></entry> 53 <entry>1152</entry> 54 <entry>864</entry> 55 <entry>32</entry> 56 <entry>4:3</entry> 57 </row> 58 <row> 59 <entry><b>HD</b></entry> 60 <entry>1280</entry> 61 <entry>720</entry> 62 <entry>32</entry> 63 <entry>16:9</entry> 64 </row> 65 <row> 66 <entry><b>WXGA</b></entry> 67 <entry>1280</entry> 68 <entry>800</entry> 69 <entry>32</entry> 70 <entry>16:10</entry> 71 </row> 72 <row> 73 <entry><b>SXGA</b></entry> 74 <entry>1280</entry> 75 <entry>1024</entry> 76 <entry>32</entry> 77 <entry>5:4</entry> 78 </row> 79 <row> 80 <entry><b>SXGA+</b></entry> 81 <entry>1400</entry> 82 <entry>1050</entry> 83 <entry>32</entry> 84 <entry>4:3</entry> 85 </row> 86 <row> 87 <entry><b>WXGA+</b></entry> 88 <entry>1440</entry> 89 <entry>900</entry> 90 <entry>32</entry> 91 <entry>16:10</entry> 92 </row> 93 <row> 94 <entry><b>HD+</b></entry> 95 <entry>1600</entry> 96 <entry>900</entry> 97 <entry>32</entry> 98 <entry>16:9</entry> 99 </row> 100 <row> 101 <entry><b>UXGA</b></entry> 102 <entry>1600</entry> 103 <entry>1200</entry> 104 <entry>32</entry> 105 <entry>4:3</entry> 106 </row> 107 <row> 108 <entry><b>WSXGA+</b></entry> 109 <entry>1680</entry> 110 <entry>1050</entry> 111 <entry>32</entry> 112 <entry>16:10</entry> 113 </row> 114 <row> 115 <entry><b>Full HD</b></entry> 116 <entry>1920</entry> 117 <entry>1080</entry> 118 <entry>32</entry> 119 <entry>16:9</entry> 120 </row> 121 <row> 122 <entry><b>WUXGA</b></entry> 123 <entry>1920</entry> 124 <entry>1200</entry> 125 <entry>32</entry> 126 <entry>16:10</entry> 127 </row> 128 <row> 129 <entry><b>DCI 2K</b></entry> 130 <entry>2048</entry> 131 <entry>1080</entry> 132 <entry>32</entry> 133 <entry>19:10</entry> 134 </row> 135 <row> 136 <entry><b>Full HD+</b></entry> 137 <entry>2160</entry> 138 <entry>1440</entry> 139 <entry>32</entry> 140 <entry>3:2</entry> 141 </row> 142 <row> 143 <entry><b>Unnamed</b></entry> 144 <entry>2304</entry> 145 <entry>1440</entry> 146 <entry>32</entry> 147 <entry>16:10</entry> 148 </row> 149 <row> 150 <entry><b>QHD</b></entry> 151 <entry>2560</entry> 152 <entry>1440</entry> 153 <entry>32</entry> 154 <entry>16:9</entry> 155 </row> 156 <row> 157 <entry><b>WQXGA</b></entry> 158 <entry>2560</entry> 159 <entry>1600</entry> 160 <entry>32</entry> 161 <entry>16:10</entry> 162 </row> 163 <row> 164 <entry><b>QWXGA+</b></entry> 165 <entry>2880</entry> 166 <entry>1800</entry> 167 <entry>32</entry> 168 <entry>16:10</entry> 169 </row> 170 <row> 171 <entry><b>QHD+</b></entry> 172 <entry>3200</entry> 173 <entry>1800</entry> 174 <entry>32</entry> 175 <entry>16:9</entry> 176 </row> 177 <row> 178 <entry><b>WQSXGA</b></entry> 179 <entry>3200</entry> 180 <entry>2048</entry> 181 <entry>32</entry> 182 <entry>16:10</entry> 183 </row> 184 <row> 185 <entry><b>4K UHD</b></entry> 186 <entry>3840</entry> 187 <entry>2160</entry> 188 <entry>32</entry> 189 <entry>16:9</entry> 190 </row> 191 <row> 192 <entry><b>WQUXGA</b></entry> 193 <entry>3840</entry> 194 <entry>2400</entry> 195 <entry>32</entry> 196 <entry>16:10</entry> 197 </row> 198 <row> 199 <entry><b>DCI 4K</b></entry> 200 <entry>4096</entry> 201 <entry>2160</entry> 202 <entry>32</entry> 203 <entry>19:10</entry> 204 </row> 205 <row> 206 <entry><b>HXGA</b></entry> 207 <entry>4096</entry> 208 <entry>3072</entry> 209 <entry>32</entry> 210 <entry>4:3</entry> 211 </row> 212 <row> 213 <entry><b>UHD+</b></entry> 214 <entry>5120</entry> 215 <entry>2880</entry> 216 <entry>32</entry> 217 <entry>16:9</entry> 218 </row> 219 <row> 220 <entry><b>WHXGA</b></entry> 221 <entry>5120</entry> 222 <entry>3200</entry> 223 <entry>32</entry> 224 <entry>16:10</entry> 225 </row> 226 <row> 227 <entry><b>WHSXGA</b></entry> 228 <entry>6400</entry> 229 <entry>4096</entry> 230 <entry>32</entry> 231 <entry>16:10</entry> 232 </row> 233 <row> 234 <entry><b>HUXGA</b></entry> 235 <entry>6400</entry> 236 <entry>4800</entry> 237 <entry>32</entry> 238 <entry>4:3</entry> 239 </row> 240 <row> 241 <entry><b>8K UHD2</b></entry> 242 <entry>7680</entry> 243 <entry>4320</entry> 244 <entry>32</entry> 245 <entry>16:9</entry> 246 </row> 247 </tbody> 248 </tgroup> 249 </table></p> 250 <p>If this list of default resolutions does not cover your needs, see <xref href="customvesa.dita">Custom VESA Resolutions</xref>. Note that the color depth value specified in a custom video mode must be specified. Color depths of 8, 16, 24, and 32 are accepted. EFI assumes a color depth of 32 by default. </p> 331 251 <p>The EFI default video resolution settings can only be changed when the VM is powered off. </p> 332 252 </body> -
trunk/doc/manual/en_US/dita/topics/vrde-crypt.dita
r105335 r106318 7 7 <p>RDP features data stream encryption, which is based on the RC4 symmetric cipher, with keys up to 128-bit. The RC4 8 8 keys are replaced at regular intervals, every 4096 packets. </p> 9 <p>RDP provides the following different authentication methods: </p>9 <p>RDP provides the following different server authentication methods: </p> 10 10 <ul> 11 11 <li> 12 <p><b outputclass="bold">RDP 4</b> authentication was 13 used historically. With RDP 4, the RDP client does not 14 perform any checks in order to verify the identity of the 15 server it connects to. Since user credentials can be 16 obtained using a man in the middle (MITM) attack, RDP4 17 authentication is insecure and should generally not be used. 18 </p> 12 <p><b outputclass="bold">RDP 4</b> authentication was used historically. With RDP 4, the RDP client does not perform any checks in order to verify the identity of the server it connects to. Since user credentials can be obtained using a man in the middle (MITM) attack, RDP4 authentication is insecure and should not be used. </p> 19 13 </li> 20 14 <li> … … 36 30 certificate to the client. 37 31 </p> 38 <p>The <codeph>Security/Method</codeph> VRDE property sets the required security method, which is used for a 39 connection. Valid values are as follows: </p> 32 <p>The <codeph>Security/Method</codeph> VRDE property sets the required security method that is used for a connection. You can also change this in the VM Settings, Remote Display tab. Valid values are as follows: </p> 40 33 <ul> 41 34 <li> 42 <p><b outputclass="bold">Negotiate.</b> Both 43 Enhanced (TLS) and Standard RDP Security connections are 44 allowed. The security method is negotiated with the 45 client. This is the default setting. 46 </p> 35 <p><b outputclass="bold">Negotiate.</b> Both Enhanced (TLS) and Standard RDP Security connections are allowed. The security method is negotiated with the client. </p> 47 36 </li> 48 37 <li> … … 52 41 </li> 53 42 <li> 54 <p><b outputclass="bold">TLS.</b> Only Enhanced RDP 55 Security is accepted. The client must support TLS. 56 </p> 43 <p><b outputclass="bold">TLS.</b> Only Enhanced RDP Security is accepted. The client must support TLS. This is the default setting. </p> 57 44 <p> 58 45 The version of OpenSSL used by <ph conkeyref="vbox-conkeyref-phrases/product-name"/> supports … … 61 48 </li> 62 49 </ul> 63 <p>For example, the following command enables a client to use either Standard or Enhanced RDP Security 64 connection: </p> 65 <pre xml:space="preserve">vboxmanage modifyvm <varname>VM-name</varname> --vrde-property "Security/Method=negotiate"</pre> 66 <p>If the <codeph>Security/Method</codeph> property is set to either Negotiate or TLS, the TLS protocol will be 67 automatically used by the server, if the client supports TLS. However, in order to use TLS the server must 68 possess the Server Certificate, the Server Private Key and the Certificate Authority (CA) Certificate. The 69 following example shows how to generate a server certificate. </p> 50 <p>For example, the following command configures a client to use either Standard or Enhanced RDP Security connection: </p> 51 <pre xml:space="preserve">VBoxManage modifyvm <varname>VM-name</varname> --vrde-property "Security/Method=negotiate"</pre> 52 <p>If the <codeph>Security/Method</codeph> property is set to either Negotiate or TLS, the server uses TLS if the client supports it. However, to use TLS the server must have the Server Certificate and the Server Private Key. A Certificate Authority (CA) Certificate is optional. </p> 53 <p>If you choose TLS as the security method, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> generates a server key and certificate pair called VRDEAutoGeneratedPrivateKey.pem and VRDEAutoGeneratedCert.pem) for the VM. <ph conkeyref="vbox-conkeyref-phrases/product-name"/> also recreates the auto-generated certificate and key if they are about to expire, or if one or both are deleted or corrupted. </p> 54 <p>To generate a custom server key and certificate pair, with a CA certificate, follow these steps. </p> 70 55 <ol> 71 56 <li> … … 85 70 </li> 86 71 </ol> 87 <p> The server must be configuredto access the required files. For example: </p>88 <pre xml:space="preserve"> vboxmanage modifyvm <varname>VM-name</varname> \72 <p>Configure the server to access the required files. For example: </p> 73 <pre xml:space="preserve">VBoxManage modifyvm <varname>VM-name</varname> \ 89 74 --vrde-property "Security/CACertificate=path/ca_cert.pem"</pre> 90 <pre xml:space="preserve"> vboxmanage modifyvm <varname>VM-name</varname> \75 <pre xml:space="preserve">VBoxManage modifyvm <varname>VM-name</varname> \ 91 76 --vrde-property "Security/ServerCertificate=path/server_cert.pem"</pre> 92 <pre xml:space="preserve"> vboxmanage modifyvm <varname>VM-name</varname> \77 <pre xml:space="preserve">VBoxManage modifyvm <varname>VM-name</varname> \ 93 78 --vrde-property "Security/ServerPrivateKey=path/server_key_private.pem"</pre> 79 <p>Note that <ph conkeyref="vbox-conkeyref-phrases/product-name"/> does not maintain custom certificates. You are responsible for keeping these updated.</p> 94 80 </li> 95 81 </ul>
Note:
See TracChangeset
for help on using the changeset viewer.
