uploaded spice-vdagent
[platform/adaptation/emulator/spice-vdagent.git] / data / spice-vdagentd.1.in
1 .TH spice-vdagentd "1" "April 2013" "@PACKAGE_STRING@"
2 .SH NAME
3 spice-vdagentd \- Spice guest agent daemon
4 .SH SYNOPSIS
5 \fBspice-vdagent\fR [\fIOPTIONS\fR]
6 .SH DESCRIPTION
7 The spice guest agent for Linux consists of 2 parts, a system wide daemon
8 \fBspice-vdagentd\fR and a X11 session agent \fBspice-vdagent\fR of which
9 there is one per X11 session.
10 .br
11 \fBspice-vdagentd\fR gets started through a Sys-V initscript or a systemd unit.
12 .SH FEATURES
13 The spice guest agent adds the following features to spice Linux guests:
14 .P
15 Client mouse mode (no need to grab mouse by client, no mouse lag)
16 .P
17 Automatic adjustment of the X11 session's number of virtual monitors, and their
18 resolution, to the number of client windows and their resolution
19 .P
20 Support of copy and paste (text and images) between the active X11 session
21 and the client, this supports both the primary selection and the clipboard
22 .P
23 Support for transfering files from the client to the agent
24 .SH OPTIONS
25 .TP
26 \fB-h\fP
27 Print a short description of all command line options
28 .TP
29 \fB-d\fP
30 Log debug messages (use twice for extra info)
31 .TP
32 \fB-s\fP \fIport\fR
33 Set virtio serial \fIport\fR (default: /dev/virtio-ports/com.redhat.spice.0)
34 .TP
35 \fB-u\fP \fIdevice\fR
36 Set uinput \fIdevice\fR (default: /dev/uinput)
37 .TP
38 \fB-x\fP
39 Don't daemonize
40 .TP
41 \fB-X\fP
42 Disable session info usage, \fBspice-vdagentd\fR needs to know which
43 \fBspice-vdagent\fR is in the currently active X11 session.
44 \fBspice-vdagentd\fR uses console kit or systemd-logind (compile time option)
45 for this; The \fB-X\fP option disables this, if no session info is available
46 only one \fBspice-vdagent\fR is allowed
47 .SH FILES
48 The Sys-V initscript or systemd unit parses the following files:
49 .TP
50 /etc/sysconfig/spice-vdagentd
51 Default cmdline options can be passed to \fBspice-vdagentd\fR by setting
52 them in the \fISPICE_VDAGENTD_EXTRA_ARGS\fR variable in this file
53 .SH SEE ALSO
54 \fBspice-vdagent\fR(1)
55 .SH COPYRIGHT
56 Copyright 2010-2013 Red Hat, Inc. License GPLv3+: GNU GPL version 3 or later
57 <http://gnu.org/licenses/gpl.html>.
58 .br
59 This is free software: you are free to change and redistribute it.
60 There is NO WARRANTY, to the extent permitted by law.