1CONSPY(1)                           conspy                           CONSPY(1)
2
3
4

NAME

6       conspy - virtual console spy tool
7

SYNOPSIS

9       conspy [ options ] [ console ]
10

DESCRIPTION

12       Conspy allows the user to take control of a Linux virtual console.  The
13       user can see what is displayed on the console and their keystrokes  are
14       sent to it.
15
16       To  exit  from conspy press the escape key three times in quick succes‐
17       sion.
18

COMMAND LINE

20       -g COLSxROWS, --geometry COLSxROWS
21              Specify the console size.  Conspy can  almost  always  correctly
22              guess  the  size  so  this  is  only useful when it complains it
23              can't.
24
25       -V, --version
26              Print the program's version and exit.
27
28       -v, --viewonly
29              Don't send keystrokes to the virtual console.
30
31       console
32              If supplied, console must be a number in the range 1 .. 63, cor‐
33              responding   to   the   virtual   console  device  /dev/tty1  ..
34              /dev/tty63.  If not supplied the currently active  virtual  con‐
35              sole is opened and tracked.
36

LIMITATIONS

38       Conspy  will not pass keystrokes to a virtual console whose keyboard is
39       configured to send scan codes.  X configures its  keyboard  like  this.
40       If  the  terminal  does  not have at least 64 colours no colour will be
41       displayed.   Conspy  ignores  the  mouse.   Conspy  may  display   some
42       non-ASCII characters incorrectly.
43
44       The kernel reports the console geometry and cursor position using bytes
45       which limits both to 255 maximum.  Conspy can usually guess the correct
46       display  size from the truncated version, but if the cursor position is
47       beyond line 255 or column 255 conspy will put it in the wrong place.
48
49       Conspy depends on terminfo and curses working correctly for your termi‐
50       nal,  and  sometimes  they  don't.  Konsole is/was one example of where
51       they don't.  Typing control-L will redraw  the  screen,  which  usually
52       fixes  the mess created.  It also sends a control-L to the virtual con‐
53       sole, of course.
54

FILES

56       /dev/ttyX, /dev/vc/X
57              The characters typed are sent to this device.  The latter is for
58              devfs. It is only used if the former does not exist.
59
60       /dev/vcsaX, /dev/vcc/aX
61              The  display of the virtual console is read from here.  The lat‐
62              ter is for devfs. It is only used if the former does not exist.
63

AUTHOR

65       Russell Stuart, <russell-conspy@stuart.id.au>.
66
67
68
69Version 1.14                       Feb 2016                          CONSPY(1)
Impressum