Signed-off-by: Zhou Peng <ailvpeng25@gmail.com> diff -r 1804a873a64d docs/man/xl.cfg.pod.5 --- a/docs/man/xl.cfg.pod.5 Tue Jun 05 17:56:46 2012 +0800 +++ b/docs/man/xl.cfg.pod.5 Tue Jun 05 18:58:12 2012 +0800 @@ -699,11 +699,14 @@ in the B<VFB_SPEC_STRING> for configurin Sets the amount of RAM which the emulated video card will contain, which in turn limits the resolutions and bit depths which will be -available. This option is only available when using the B<stdvga> -option (see below). The default is 8MB which is sufficient for -e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the -amount of video ram is fixed at 4MB which is sufficient for 1024x768 +available. This option is available when using the B<stdvga> and +B<qxl> options (see below). +For B<stdvga> option, the default is 8MB which is sufficient for +e.g. 1600x1200 at 32bpp. When not using the B<stdvga> and B<qxl> options, +the amount of video ram is fixed at 4MB which is sufficient for 1024x768 at 32 bpp. +For B<qxl> option, it may be adjusted automatically (see B<qxlram> +option below). =item B<stdvga=BOOLEAN> @@ -711,6 +714,27 @@ emulated graphics device. The default is emulated graphics device. The default is false which means to emulate a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or later (e.g. Windows XP onwards) then you should enable this. + +=item B<qxl=BOOLEAN> + +Select a QXL VGA card as the emulated graphics device. This enables +the other QXL-related settings. +In general, QXL should work with the Spice remote display protocol for +acceleration, but QXL driver is necessary in guest. QXL can also work +with the VNC protocol like a standard VGA without acceleration. + +=item B<qxlram=MBYTES> + +Sets the amount of RAM bar for QXL VGA card. The default is 64 MiB. +The total size of QXL video memory is determined by B<qxlram> (RAM bar) +and B<qxlvram> (VRAM bar), the size of each is settable. +B<videoram> can set the amount of RAM which emulated video card +will contain, but if it can''t meet the need of QXL, it will be +adjusted accordingly. + +=item B<qxlvram=MBYTES> + +Sets the amount of VRAM bar for QXL VGA card. The default is 64 MiB. =item B<vnc=BOOLEAN> -- Zhou Peng _______________________________________________ Xen-devel mailing list Xen-devel@lists.xen.org http://lists.xen.org/xen-devel
On Tue, 2012-06-05 at 12:26 +0100, ZhouPeng wrote:> Signed-off-by: Zhou Peng <ailvpeng25@gmail.com>You can/should include this with the patch which adds the functionality, no need to separate it out.> > diff -r 1804a873a64d docs/man/xl.cfg.pod.5 > --- a/docs/man/xl.cfg.pod.5 Tue Jun 05 17:56:46 2012 +0800 > +++ b/docs/man/xl.cfg.pod.5 Tue Jun 05 18:58:12 2012 +0800 > @@ -699,11 +699,14 @@ in the B<VFB_SPEC_STRING> for configurin > > Sets the amount of RAM which the emulated video card will contain, > which in turn limits the resolutions and bit depths which will be > -available. This option is only available when using the B<stdvga> > -option (see below). The default is 8MB which is sufficient for > -e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the > -amount of video ram is fixed at 4MB which is sufficient for 1024x768 > +available. This option is available when using the B<stdvga> and > +B<qxl> options (see below). > +For B<stdvga> option, the default is 8MB which is sufficient for > +e.g. 1600x1200 at 32bpp. When not using the B<stdvga> and B<qxl> options, > +the amount of video ram is fixed at 4MB which is sufficient for 1024x768 > at 32 bpp. > +For B<qxl> option, it may be adjusted automatically (see B<qxlram> > +option below). > > =item B<stdvga=BOOLEAN> > > @@ -711,6 +714,27 @@ emulated graphics device. The default is > emulated graphics device. The default is false which means to emulate > a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or > later (e.g. Windows XP onwards) then you should enable this. > + > +=item B<qxl=BOOLEAN> > + > +Select a QXL VGA card as the emulated graphics device. This enables > +the other QXL-related settings. > +In general, QXL should work with the Spice remote display protocol for > +acceleration, but QXL driver is necessary in guest. QXL can also work > +with the VNC protocol like a standard VGA without acceleration. > + > +=item B<qxlram=MBYTES> > + > +Sets the amount of RAM bar for QXL VGA card. The default is 64 MiB. > +The total size of QXL video memory is determined by B<qxlram> (RAM bar) > +and B<qxlvram> (VRAM bar), the size of each is settable. > +B<videoram> can set the amount of RAM which emulated video card > +will contain, but if it can''t meet the need of QXL, it will be > +adjusted accordingly. > + > +=item B<qxlvram=MBYTES> > + > +Sets the amount of VRAM bar for QXL VGA card. The default is 64 MiB.It''s not clear to me having read this what the distinction between RAM and VRAM is in the context of QXL. When and why would I want to set either? Ian.
On Wed, Jun 6, 2012 at 9:07 PM, Ian Campbell <Ian.Campbell@citrix.com> wrote:> On Tue, 2012-06-05 at 12:26 +0100, ZhouPeng wrote: >> Signed-off-by: Zhou Peng <ailvpeng25@gmail.com> > > You can/should include this with the patch which adds the functionality, > no need to separate it out.Ok.> >> >> diff -r 1804a873a64d docs/man/xl.cfg.pod.5 >> --- a/docs/man/xl.cfg.pod.5 Tue Jun 05 17:56:46 2012 +0800 >> +++ b/docs/man/xl.cfg.pod.5 Tue Jun 05 18:58:12 2012 +0800 >> @@ -699,11 +699,14 @@ in the B<VFB_SPEC_STRING> for configurin >> >> Sets the amount of RAM which the emulated video card will contain, >> which in turn limits the resolutions and bit depths which will be >> -available. This option is only available when using the B<stdvga> >> -option (see below). The default is 8MB which is sufficient for >> -e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the >> -amount of video ram is fixed at 4MB which is sufficient for 1024x768 >> +available. This option is available when using the B<stdvga> and >> +B<qxl> options (see below). >> +For B<stdvga> option, the default is 8MB which is sufficient for >> +e.g. 1600x1200 at 32bpp. When not using the B<stdvga> and B<qxl> options, >> +the amount of video ram is fixed at 4MB which is sufficient for 1024x768 >> at 32 bpp. >> +For B<qxl> option, it may be adjusted automatically (see B<qxlram> >> +option below). >> >> =item B<stdvga=BOOLEAN> >> >> @@ -711,6 +714,27 @@ emulated graphics device. The default is >> emulated graphics device. The default is false which means to emulate >> a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or >> later (e.g. Windows XP onwards) then you should enable this. >> + >> +=item B<qxl=BOOLEAN> >> + >> +Select a QXL VGA card as the emulated graphics device. This enables >> +the other QXL-related settings. >> +In general, QXL should work with the Spice remote display protocol for >> +acceleration, but QXL driver is necessary in guest. QXL can also work >> +with the VNC protocol like a standard VGA without acceleration. >> + >> +=item B<qxlram=MBYTES> >> + >> +Sets the amount of RAM bar for QXL VGA card. The default is 64 MiB. >> +The total size of QXL video memory is determined by B<qxlram> (RAM bar) >> +and B<qxlvram> (VRAM bar), the size of each is settable. >> +B<videoram> can set the amount of RAM which emulated video card >> +will contain, but if it can''t meet the need of QXL, it will be >> +adjusted accordingly. >> + >> +=item B<qxlvram=MBYTES> >> + >> +Sets the amount of VRAM bar for QXL VGA card. The default is 64 MiB. > > It''s not clear to me having read this what the distinction between RAM > and VRAM is in the context of QXL. When and why would I want to set > either?Both of them are necessary to set qxl video ram. They are necessary paremeters of qxl. Any way, I will rich the document if get more info. Thanks.> Ian. >-- Zhou Peng
On Thu, 2012-06-07 at 04:22 +0100, ZhouPeng wrote:> On Wed, Jun 6, 2012 at 9:07 PM, Ian Campbell <Ian.Campbell@citrix.com> wrote: > > On Tue, 2012-06-05 at 12:26 +0100, ZhouPeng wrote: > >> Signed-off-by: Zhou Peng <ailvpeng25@gmail.com> > > > > You can/should include this with the patch which adds the functionality, > > no need to separate it out. > Ok. > > > >> > >> diff -r 1804a873a64d docs/man/xl.cfg.pod.5 > >> --- a/docs/man/xl.cfg.pod.5 Tue Jun 05 17:56:46 2012 +0800 > >> +++ b/docs/man/xl.cfg.pod.5 Tue Jun 05 18:58:12 2012 +0800 > >> @@ -699,11 +699,14 @@ in the B<VFB_SPEC_STRING> for configurin > >> > >> Sets the amount of RAM which the emulated video card will contain, > >> which in turn limits the resolutions and bit depths which will be > >> -available. This option is only available when using the B<stdvga> > >> -option (see below). The default is 8MB which is sufficient for > >> -e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the > >> -amount of video ram is fixed at 4MB which is sufficient for 1024x768 > >> +available. This option is available when using the B<stdvga> and > >> +B<qxl> options (see below). > >> +For B<stdvga> option, the default is 8MB which is sufficient for > >> +e.g. 1600x1200 at 32bpp. When not using the B<stdvga> and B<qxl> options, > >> +the amount of video ram is fixed at 4MB which is sufficient for 1024x768 > >> at 32 bpp. > >> +For B<qxl> option, it may be adjusted automatically (see B<qxlram> > >> +option below). > >> > >> =item B<stdvga=BOOLEAN> > >> > >> @@ -711,6 +714,27 @@ emulated graphics device. The default is > >> emulated graphics device. The default is false which means to emulate > >> a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or > >> later (e.g. Windows XP onwards) then you should enable this. > >> + > >> +=item B<qxl=BOOLEAN> > >> + > >> +Select a QXL VGA card as the emulated graphics device. This enables > >> +the other QXL-related settings. > >> +In general, QXL should work with the Spice remote display protocol for > >> +acceleration, but QXL driver is necessary in guest. QXL can also work > >> +with the VNC protocol like a standard VGA without acceleration. > >> + > >> +=item B<qxlram=MBYTES> > >> + > >> +Sets the amount of RAM bar for QXL VGA card. The default is 64 MiB. > >> +The total size of QXL video memory is determined by B<qxlram> (RAM bar) > >> +and B<qxlvram> (VRAM bar), the size of each is settable. > >> +B<videoram> can set the amount of RAM which emulated video card > >> +will contain, but if it can''t meet the need of QXL, it will be > >> +adjusted accordingly. > >> + > >> +=item B<qxlvram=MBYTES> > >> + > >> +Sets the amount of VRAM bar for QXL VGA card. The default is 64 MiB. > > > > It''s not clear to me having read this what the distinction between RAM > > and VRAM is in the context of QXL. When and why would I want to set > > either? > Both of them are necessary to set qxl video ram. > They are necessary paremeters of qxl.But they aren''t necessary at the xl layer, right? I can just omit them and a correct value will be chosen for me?> > Any way, I will rich the document if get more info. > Thanks. > > Ian. > > > > >
On Thu, Jun 7, 2012 at 2:24 PM, Ian Campbell <Ian.Campbell@citrix.com> wrote:> On Thu, 2012-06-07 at 04:22 +0100, ZhouPeng wrote: >> On Wed, Jun 6, 2012 at 9:07 PM, Ian Campbell <Ian.Campbell@citrix.com> wrote: >> > On Tue, 2012-06-05 at 12:26 +0100, ZhouPeng wrote: >> >> Signed-off-by: Zhou Peng <ailvpeng25@gmail.com> >> > >> > You can/should include this with the patch which adds the functionality, >> > no need to separate it out. >> Ok. >> > >> >> >> >> diff -r 1804a873a64d docs/man/xl.cfg.pod.5 >> >> --- a/docs/man/xl.cfg.pod.5 Tue Jun 05 17:56:46 2012 +0800 >> >> +++ b/docs/man/xl.cfg.pod.5 Tue Jun 05 18:58:12 2012 +0800 >> >> @@ -699,11 +699,14 @@ in the B<VFB_SPEC_STRING> for configurin >> >> >> >> Sets the amount of RAM which the emulated video card will contain, >> >> which in turn limits the resolutions and bit depths which will be >> >> -available. This option is only available when using the B<stdvga> >> >> -option (see below). The default is 8MB which is sufficient for >> >> -e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the >> >> -amount of video ram is fixed at 4MB which is sufficient for 1024x768 >> >> +available. This option is available when using the B<stdvga> and >> >> +B<qxl> options (see below). >> >> +For B<stdvga> option, the default is 8MB which is sufficient for >> >> +e.g. 1600x1200 at 32bpp. When not using the B<stdvga> and B<qxl> options, >> >> +the amount of video ram is fixed at 4MB which is sufficient for 1024x768 >> >> at 32 bpp. >> >> +For B<qxl> option, it may be adjusted automatically (see B<qxlram> >> >> +option below). >> >> >> >> =item B<stdvga=BOOLEAN> >> >> >> >> @@ -711,6 +714,27 @@ emulated graphics device. The default is >> >> emulated graphics device. The default is false which means to emulate >> >> a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or >> >> later (e.g. Windows XP onwards) then you should enable this. >> >> + >> >> +=item B<qxl=BOOLEAN> >> >> + >> >> +Select a QXL VGA card as the emulated graphics device. This enables >> >> +the other QXL-related settings. >> >> +In general, QXL should work with the Spice remote display protocol for >> >> +acceleration, but QXL driver is necessary in guest. QXL can also work >> >> +with the VNC protocol like a standard VGA without acceleration. >> >> + >> >> +=item B<qxlram=MBYTES> >> >> + >> >> +Sets the amount of RAM bar for QXL VGA card. The default is 64 MiB. >> >> +The total size of QXL video memory is determined by B<qxlram> (RAM bar) >> >> +and B<qxlvram> (VRAM bar), the size of each is settable. >> >> +B<videoram> can set the amount of RAM which emulated video card >> >> +will contain, but if it can''t meet the need of QXL, it will be >> >> +adjusted accordingly. >> >> + >> >> +=item B<qxlvram=MBYTES> >> >> + >> >> +Sets the amount of VRAM bar for QXL VGA card. The default is 64 MiB. >> > >> > It''s not clear to me having read this what the distinction between RAM >> > and VRAM is in the context of QXL. When and why would I want to set >> > either? >> Both of them are necessary to set qxl video ram. >> They are necessary paremeters of qxl. > > But they aren''t necessary at the xl layer, right? I can just omit them > and a correct value will be chosen for me?I means if user want to adjust the qxl total ram, both parameters are necessary to be considered. But if just use the default, both can be omitted, and a correct value will be chosen by qxl (which is like get_qxl_ram(64, 64) = 128).> >> >> Any way, I will rich the document if get more info. >> Thanks. >> > Ian. >> > >> >> >> > >-- Zhou Peng