Commit Graph

65 Commits

Author SHA1 Message Date
Daniel P. Berrangé
beeff760ac docs: update to point users to gitlab.com project
The project primary git repo has moved from pagure.io to
gitlab.com/virt-viewer/virt-viewer.  We want users to submit
code contributions, bug reports and support questions to the
gitlab project, not the mailing list, nor bugzilla, nor the
virt-manager.org site.

We're still using virt-manager.org for hosting downloads of
source and pagure.io for MSIs, but we'll aim to change that
too.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-04-03 14:08:10 +01:00
ceb21d7894 remote-viewer: Allow toggling shared clipboard
Signed-off-by: Aleksei Nikiforov <darktemplar@basealt.ru>
Message-Id: <20190304143712.27989-1-darktemplar@basealt.ru>
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
2019-03-07 19:52:00 +01:00
Marc-André Lureau
be5ff83dfc spice: add unix-path in .vv file support
This will allow to connect to a Spice server using a unix socket path,
for example:

[virt-viewer]
type=spice
unix-path=/var/run/user/1000/qemu/test/spice.sock

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Christophe Fergeau <cfergeau@redhat.com>
2018-12-21 16:53:35 +04:00
Eduardo Lima (Etrunko)
24fc358862 doc: Adjust reference to spice-gtk man page for remote-viewer
Similar to last commit, as noticed by reporter in bugzilla:

https://bugzilla.redhat.com/show_bug.cgi?id=1477966

Man page should reference spice-client, not spice-gtk.

Signed-off-by: Eduardo Lima (Etrunko) <etrunko@redhat.com>
Acked-by: Victor Toso <victortoso@redhat.com>
2017-11-22 16:17:27 -02:00
Christophe Fergeau
1b89efaa28 doc: Adjust reference to spice-gtk man page
The man page spice-gtk ships is named "spice-client", not "spice-gtk"

Signed-off-by: Christophe Fergeau <cfergeau@redhat.com>
Reviewed-by: Daniel P. Berrange <berrange@redhat.com>

https://bugzilla.redhat.com/show_bug.cgi?id=1477966
2017-11-17 15:14:44 -02:00
Marc-André Lureau
140cb84c25 remote-viewer: remove --spice-controller
spice controller interface is being removed from spice-gtk.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Victor Toso <victortoso@redhat.com>
2017-11-16 17:04:05 +01:00
Marc-André Lureau
ce7fd6eb45 remote-viewer: learn '-' as URI for standard input connection file
Some users want the ability to set connection details without writing
to a file or passing command line arguments.

Learn to read the connection file from standard input for such use
case.

This allows a parent process to set the connection details without
intermediary file.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Victor Toso <victortoso@redhat.com>
2017-11-16 17:04:02 +01:00
Pavel Grunt
11d8676ba4 virt-viewer: Adjust name-id-uuid comment
virt-viewer by default chooses the VM by its id, then uuid
and then by name. Adjust the comment to match the implementation.

Related: rhbz#1399077
2017-03-09 12:59:10 +01:00
Pavel Grunt
61292f3063 virt-viewer: Allow more precise VM selection
Theoretically a VM name can be a valid VM id or uuid. In that case
connecting to the VMs may be problematic since virt-viewer selects
the VM by its id then by uuid if not found then by its name.

Introduce new command line options to cover this situation:
 "--id" to connect to the VM by its id
 "--uuid" to connect to the VM by its uuid
 "--domain-name" to connect to the VM by its name
The options are mutually exclusive

Resolves: rhbz#1399077
2017-03-09 12:59:03 +01:00
Christophe Fergeau
cb2be722cf man: Fix qemu+ssh URL in example
The 'system' path was missing: qemu+ssh://example.org/system

Resolves: rhbz#1377283
2017-02-17 13:31:52 +01:00
Christophe Fergeau
276012ea37 man: Mention that ssh-agent can be useful
When using a tunneled SPICE connection, the user will get a dozen
authentication prompts if they are not using ssh-agent.

https://bugzilla.redhat.com/show_bug.cgi?id=1377283
2016-12-05 10:59:24 +01:00
Christophe Fergeau
4f37332940 ovirt: Use sso-token when set in .vv file
Starting with oVirt 4.0, this replaces the jsessionid field for
automatic authentication with oVirt instances for REST communication.
2016-05-10 09:51:14 +02:00
Pavel Grunt
4048d28de8 manpage: Mention spice-gtk in See also section 2016-04-22 17:05:07 +02:00
Eduardo Lima (Etrunko)
69e0476314 Update MAINTAINERCLEANFILES variables
Makefile.am: Use helper variables from git.mk
man/Makefile.am: This should be $(dist_man_MANS) instead of $(man_MANS)

Signed-off-by: Eduardo Lima (Etrunko) <etrunko@redhat.com>
2015-11-04 12:17:16 -02:00
Christophe Fergeau
a9967fd2f6 vv-file: Add 'newer-version-url' key to .vv files
If set, this URL will be displayed when one of the version checks
('version' of 'versions' key fail). This URL should contain explanations
about how to get an updated remote-viewer version.
2015-06-09 18:06:39 +02:00
Christophe Fergeau
e2df5a739a util: Replace virt_viewer_compare_version with _compare_buildid
This allows us to do a more accurate version check if the .vv file
producer wants to allow builds newer than x.y-z because they contain an
important bug fix.
2015-06-09 18:06:39 +02:00
Christophe Fergeau
fd1052ad5d vv-file: Add VirtViewerFile::versions
Specifying a single minimal version in the .vv file is not enough as
the client version will be highly dependent on the OS it's running in.
Windows versioning is not the same as linux versioning, Fedora 21 and
Fedora 22 may have different release numbers for the same version,
and we may want to force a specific minimal release in case of a
critical bug fix.

This commit adds supports for a 'versions' field in .vv files where a
list of os-id:version couples can be stored.
2015-06-09 18:06:39 +02:00
Pavel Grunt
233c61eaea monitor-mapping: Do not allow to skip a display
Skipping a display does not have an effect because displays will be
reconfigured and shifted on the guest side anyway.

these monitor mappings are not valid:
 'monitor-mapping=1:2;3:1' - display #2 is not specified
 'monitor-mapping=4:2;2:1' - displays #1, #3 are not specified
 'monitor-mapping=3:3'     - displays #1, #2 are not specified
2015-06-04 10:58:09 +02:00
Pavel Grunt
ea42d03027 Revert "man: document that '--wait' requires domain as parameter"
This reverts commit 9ba2d28a0f.

Commit a830275344 required the domain
name to be placed just after the '--wait' option. It broke the
command line api, because running 'virt-viewer $vm --wait' was considered
as the error.

Related: rhbz#1209398, rhbz#1211573
2015-04-14 18:21:11 +02:00
Pavel Grunt
9ba2d28a0f man: document that '--wait' requires domain as parameter
related: rhbz#1211573
2015-04-14 15:05:11 +02:00
Pavel Grunt
5fa7ef636e man: document usage of domain name as optional
related: rhbz#1211573
2015-04-14 15:05:11 +02:00
Daniel P. Berrange
6b72c98cff Fix typo s/to to/to/ 2014-10-27 16:39:06 +00:00
Christophe Fergeau
7bc8ceea38 man: Improve documentation for 'version' field in vv files 2014-10-23 13:47:11 +02:00
Christophe Fergeau
334169749e man: Document [ovirt] section in .vv files
Add documentation for these options even though they are mainly meant to
be set by the oVirt portal when it generates the .vv file.
2014-10-09 17:21:26 +02:00
Christophe Fergeau
53b347c92c man: Improve doc for 'ca' in .vv files
Make it clearer that this CA will be used to validate the certificate
presented by the remote SPICE host when using TLS.
2014-10-09 17:21:26 +02:00
Christophe Fergeau
d2fb85642a Fix 'seperate' typo in man page/comments 2014-10-09 17:21:26 +02:00
Jonathon Jongsma
0107214070 Add example of an oVirt URI to the manpage
https://bugzilla.redhat.com/show_bug.cgi?id=1142769
2014-09-26 09:22:12 -05:00
Jonathon Jongsma
882a59596d Add documentation for fullscreen monitor mapping
see https://bugzilla.redhat.com/show_bug.cgi?id=1142769
2014-09-26 09:22:12 -05:00
Marc-André Lureau
687b9e0bfa man: fix zoom level range
https://bugzilla.redhat.com/show_bug.cgi?id=1111428
2014-06-20 13:36:04 +02:00
Marc-André Lureau
5ab6eb7b33 build-sys: man Makefile.am misc improvements
Make it silent.
Ship man files in tarball.
Use maintainer-clean instead of distclean (which is for files generated
by configure in general).
2014-04-17 11:48:01 +02:00
Marc-André Lureau
e423cb4879 man: remove Perl header
Remove "User Contributed Perl Documentation" header.
2014-04-17 11:48:00 +02:00
Christophe Fergeau
125ee741ae man: Use nicer link to GPLv2
As pointed out by Eric Blake,
https://www.gnu.org/licenses/gpl-2.0.html and
https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
both point to the same location, with the former being nicer to read.
2014-04-07 09:08:32 +02:00
Christophe Fergeau
de91f40ca4 man: Fix 'concatonated' typo
This also removes an extra 'are' in the same sentence.
2014-04-04 14:49:20 +02:00
Christophe Fergeau
6d5f3936d0 man: Fix link to GPLv2 text
The unversionned http links point to the GLPv3 text while virt-viewer is
still licensed under the GPLv2.
2014-04-04 14:49:20 +02:00
Christophe Fergeau
08eacf3181 man: Add missing '.' at end of one sentence 2014-04-04 14:49:20 +02:00
Christophe Fergeau
7f0656a861 Update user-visible copyright information
Years in copyright notices in the about dialog and man pages is at most
2012, let's set it to 2014
2014-04-04 14:49:20 +02:00
Christophe Fergeau
e0e25be56d Fix 'silentely' typo in remote-viewer man page 2014-03-14 09:01:50 +01:00
Daniel P. Berrange
7d7d324387 Improve docs for --attach flag in virt-viewer
People seem to have a hard time understanding the --attach flag.
Rewrite the docs in the hope that people figure it out this time.

Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2014-02-24 10:19:58 +00:00
Jonathon Jongsma
bd914bdea2 Drop basic fullscreen mode
Remove the distinction between --full-screen and --full-screen=auto-conf.  Just
make --full-screen behave like auto-conf did.  There's really no advantage to
having two slightly different fullscreen startup modes.
2013-11-13 11:10:06 +01:00
Christophe Fergeau
a108fee51b Fix typo in manpage
This fixes https://bugzilla.redhat.com/show_bug.cgi?id=823916
2013-10-29 15:12:17 +01:00
Jonathon Jongsma
6cc70f4fe4 Update hotkeys documentation in manpage
Describe the expected behavior of the hotkey bindings in a bit more detail.
2013-09-10 08:06:15 +02:00
Marc-André Lureau
91928798e4 kiosk: add --kiosk-quit option
In kiosk mode, it's useful to keep the app alive, even if the remote
session ended for example. Ie, we want to prevent the app from quiting
itself, even if the remote end closed, lost network, or crashed etc.
2013-08-20 20:46:25 +02:00
Marc-André Lureau
34eab7b91e kiosk: add app kiosk option, pass it down to window
See man page update for details.
2013-08-20 13:44:04 +02:00
Marc-André Lureau
692129ab44 man: add application/x-virt-viewer file format description
https://bugzilla.redhat.com/show_bug.cgi?id=970825
2013-08-08 16:57:49 +02:00
Christophe Fergeau
9ca68938da Use -H instead of -h for the short --hotkeys
-h conflicts with the short version of --help.

Fixes rhbz#980846
2013-07-03 21:18:41 +02:00
Marc-André Lureau
9ddce05ce7 man: document auto-conf fullscreen option
https://bugzilla.redhat.com/show_bug.cgi?id=875559
2013-05-24 17:40:47 +02:00
Marc-André Lureau
b0557015a9 man: document running remote-viewer without URI
https://bugzilla.redhat.com/show_bug.cgi?id=882133
2013-05-13 14:26:45 +02:00
Marc-André Lureau
9b1ad0b118 Add -- to seperate program arguments to server in man / --help
Since some of the arguments are expecting following value, make it more
explicit in the man and --help that -- can seperate options from server
name or location.

https://bugzilla.redhat.com/show_bug.cgi?id=843103
2013-05-13 14:26:45 +02:00
Hans de Goede
008491a2d9 Make hotkey configuration functionality available from the cmdline (v2)
Changes in v2:
-Add --hotkeys documentation to the man-pages

Signed-off-by: Hans de Goede <hdegoede@redhat.com>
2012-12-21 10:54:27 +01:00
Daniel P. Berrange
fe485f22de Allow user to set a window title for remote-viewer
Currently the remote viewer windows get the URI as their
title. Provide a --title STRING arg to remote-viewer to
let the user override the title with something more
meaningful to them.

Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2012-10-09 17:25:19 +01:00