| Message ID | 1498557807-10810-12-git-send-email-al1img@gmail.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
On Tue, Jun 27, 2017 at 01:03:27PM +0300, Oleksandr Grytsov wrote: > From: Oleksandr Grytsov <oleksandr_grytsov@epam.com> > > Signed-off-by: Oleksandr Grytsov <oleksandr_grytsov@epam.com> > --- > docs/man/xl.cfg.pod.5.in | 54 ++++++++++++++++++++++++++++++++++++++++++++++++ > docs/man/xl.pod.1.in | 42 +++++++++++++++++++++++++++++++++++++ > 2 files changed, 96 insertions(+) > > diff --git a/docs/man/xl.cfg.pod.5.in b/docs/man/xl.cfg.pod.5.in > index 13167ff..f181f34 100644 > --- a/docs/man/xl.cfg.pod.5.in > +++ b/docs/man/xl.cfg.pod.5.in > @@ -1096,6 +1096,60 @@ FIFO-based event channel ABI support up to 131,071 event channels. > Other guests are limited to 4095 (64-bit x86 and ARM) or 1023 (32-bit > x86). > > +=item B<vdispl=[ "VDISPL_SPEC_STRING", "VDISPL_SPEC_STRING", ...]> > + > +Specifies the virtual display devices to be provided to the guest. > + > +Each B<VDISPL_SPEC_STRING> is a comma-separated list of C<KEY=VALUE> > +settings, from the following list: > + > +=over 4 > + > +=item C<backend=DOMAIN> > + > +Specifies the backend domain name or id. If not specified Domain-0 is used. > + > +=item C<devId=device-id> > + Can we avoid camel case? > +Specified virtual display device ID. If not specified will be assigned > +automatically. > + > +=item C<beAlloc=BOOLEAN> > + Just "allocator"?
Same as for idl file. I prefer to have name similar to one in the protocol. To avoid camel case it can be renamed to be-alloc. On Thu, Jun 29, 2017 at 8:36 PM, Wei Liu <wei.liu2@citrix.com> wrote: > On Tue, Jun 27, 2017 at 01:03:27PM +0300, Oleksandr Grytsov wrote: >> From: Oleksandr Grytsov <oleksandr_grytsov@epam.com> >> >> Signed-off-by: Oleksandr Grytsov <oleksandr_grytsov@epam.com> >> --- >> docs/man/xl.cfg.pod.5.in | 54 ++++++++++++++++++++++++++++++++++++++++++++++++ >> docs/man/xl.pod.1.in | 42 +++++++++++++++++++++++++++++++++++++ >> 2 files changed, 96 insertions(+) >> >> diff --git a/docs/man/xl.cfg.pod.5.in b/docs/man/xl.cfg.pod.5.in >> index 13167ff..f181f34 100644 >> --- a/docs/man/xl.cfg.pod.5.in >> +++ b/docs/man/xl.cfg.pod.5.in >> @@ -1096,6 +1096,60 @@ FIFO-based event channel ABI support up to 131,071 event channels. >> Other guests are limited to 4095 (64-bit x86 and ARM) or 1023 (32-bit >> x86). >> >> +=item B<vdispl=[ "VDISPL_SPEC_STRING", "VDISPL_SPEC_STRING", ...]> >> + >> +Specifies the virtual display devices to be provided to the guest. >> + >> +Each B<VDISPL_SPEC_STRING> is a comma-separated list of C<KEY=VALUE> >> +settings, from the following list: >> + >> +=over 4 >> + >> +=item C<backend=DOMAIN> >> + >> +Specifies the backend domain name or id. If not specified Domain-0 is used. >> + >> +=item C<devId=device-id> >> + > > Can we avoid camel case? > >> +Specified virtual display device ID. If not specified will be assigned >> +automatically. >> + >> +=item C<beAlloc=BOOLEAN> >> + > > Just "allocator"?
diff --git a/docs/man/xl.cfg.pod.5.in b/docs/man/xl.cfg.pod.5.in index 13167ff..f181f34 100644 --- a/docs/man/xl.cfg.pod.5.in +++ b/docs/man/xl.cfg.pod.5.in @@ -1096,6 +1096,60 @@ FIFO-based event channel ABI support up to 131,071 event channels. Other guests are limited to 4095 (64-bit x86 and ARM) or 1023 (32-bit x86). +=item B<vdispl=[ "VDISPL_SPEC_STRING", "VDISPL_SPEC_STRING", ...]> + +Specifies the virtual display devices to be provided to the guest. + +Each B<VDISPL_SPEC_STRING> is a comma-separated list of C<KEY=VALUE> +settings, from the following list: + +=over 4 + +=item C<backend=DOMAIN> + +Specifies the backend domain name or id. If not specified Domain-0 is used. + +=item C<devId=device-id> + +Specified virtual display device ID. If not specified will be assigned +automatically. + +=item C<beAlloc=BOOLEAN> + +Indicates if backend can be a buffer provider/allocator for this domain. See +display protocol for details. + +=item C<connectors=CONNECTORS> + +Specifies virtual connectors for the device in following format +<id>:<W>x<H>;<id>:<W>x<H>... where: + +=over 4 + +=item C<id> + +String connector ID. Space, comma symbols are not allowed. + +=item C<W> + +Connector width in pixels. + +=item C<H> + +Connector height in pixels. + +=back + +B<EXAMPLE> + +=over 4 + +connectors=id0:1920x1080;id1:800x600;id2:640x480 + +=back + +=back + =back =head2 Paravirtualised (PV) Guest Specific Options diff --git a/docs/man/xl.pod.1.in b/docs/man/xl.pod.1.in index 78bf884..a6093c3 100644 --- a/docs/man/xl.pod.1.in +++ b/docs/man/xl.pod.1.in @@ -1451,6 +1451,48 @@ List virtual trusted platform modules for a domain. =back +=head2 VDISPL DEVICES + +=over 4 + +=item B<vdispl-attach> I<domain-id> I<vdispl-device> + +Creates a new vdispl device in the domain specified by I<domain-id>. +I<vdispl-device> describes the device to attach, using the same format as the +B<vdispl> string in the domain config file. See L<xl.cfg> for +more information. + +B<NOTES> + +=over 4 + +As in I<vdispl-device> string semicolon is used then put quotes or escaping +when using from the shell. + +B<EXAMPLE> + +=over 4 + +xl vdispl-attach DomU connectors='id0:1920x1080;id1:800x600;id2:640x480' + +or + +xl vdispl-attach DomU connectors=id0:1920x1080\;id1:800x600\;id2:640x480 + +=back + +=back + +=item B<vdispl-detach> I<domain-id> I<dev-id> + +Removes the vdispl device specified by I<dev-id> from the domain specified by I<domain-id>. + +=item B<vdispl-list> I<domain-id> + +List virtual displays for a domain. + +=back + =head1 PCI PASS-THROUGH =over 4