[virt-tools-list] [PATCH] Improve docs for --attach flag in virt-viewer

[Christophe Fergeau]

On Wed, Jan 29, 2014 at 04:24:10PM +0000, Daniel P. Berrange wrote:
> People seem to have a hard time understanding the --attach flag.
> Rewrite the docs in the hope that people figure it out this time.

ACK, didn't know libvirt/virt-viewer could do that (that is, assuming I
understand the description correctly ;)

Christophe

> 
> Signed-off-by: Daniel P. Berrange <berrange at redhat.com>
> ---
>  man/virt-viewer.pod | 11 +++++++----
>  1 file changed, 7 insertions(+), 4 deletions(-)
> 
> diff --git a/man/virt-viewer.pod b/man/virt-viewer.pod
> index 963d7bc..2d4ab2c 100644
> --- a/man/virt-viewer.pod
> +++ b/man/virt-viewer.pod
> @@ -59,10 +59,13 @@ used SSH.
>  
>  =item -a, --attach
>  
> -Use libvirt to directly attach to a local display, instead of making a
> -TCP/UNIX socket connection. This avoids the need to authentication with
> -the remote display, if authentication with libvirt is already allowed.
> -This option does not work with remote displays.
> +Instead of making a direct TCP/UNIX socket connection to the remote display,
> +ask libvirt to provide a pre-connected socket for the display. This avoids
> +the need to authenticate with the remote display server directly. This option
> +will only work when connecting to a guest that is running on the same host
> +as the virt-viewer program. If attaching to the guest via libvirt fails,
> +virt-viewer will automatically fallback to trying a regular direct TCP/UNIX
> +socket connection.
>  
>  =item -f, --full-screen
>  
> -- 
> 1.8.4.2
> 
> _______________________________________________
> virt-tools-list mailing list
> virt-tools-list at redhat.com
> https://www.redhat.com/mailman/listinfo/virt-tools-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 181 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/virt-tools-list/attachments/20140130/059cfc32/attachment.sig>