NAME

       twiglet - observe or control an RVC-enabled machine's console

SYNOPSIS

       twiglet [OPTION]... host-specification

DESCRIPTION

       twiglet  is a program for controlling another machine's console.  It works using the RVC protocol, and an
       RVC server (such as rvcd(1)) must be running on the machine to be observed.

       Using twiglet, the a best effort attempt is made  to  duplicate  the  screen  contents  of  the  observed
       machine.  If the machine is displaying a virtual text console, the text on the console is rendered in the
       terminal in which twiglet runs.  If the machine is displaying an X session, and the RVC  server  supports
       VNC integration, twiglet will open a window that contains the current contents of the X display.

       It  is also possible to control the observed machine in various ways.  With keyboard control enabled (and
       with support from the RVC server), keys may be sent to the observed machine in text console  mode  almost
       as if they were typed from the keyboard.  Twiglet also supports switching virtual console on the observed
       machine.  Finally, if VNC integration is available, the X display can be manipulated  almost  as  if  the
       user were at the console.

       The  intended  use  for  twiglet  is  in  training and teaching environments.  The idea is that there are
       student machines and a control machine (which the trainer or teacher would be using), with a serial  line
       attached  to  each  student  machine.   The trainer or teacher can then analyse the students' attempts to
       complete tasks, and help them out (showing them how to finish it) without needed to push  them  aside  to
       get to the keyboard.

       This client is written using ncurses(3X).

OPTIONS

       --help display a help message and exit successfully

       --version
              display a version number and exit successfully

       -c, --control
              control the remote machine rather than just observing it

       -e xy, --escape xy
              set the escape character and the escape escape character (like screen(1))

       The host-specification takes one of the following forms:

       host:port
              to connect to an RVC server over TCP

       tty [host]
              to communicate with an RVC server over a tty (for example a serial line); the optional hostname is
              for VNC integration

BUGS

       I'm sure there are bugs, but I don't know what they are.

AUTHOR

       Tim Waugh <twaugh@redhat.com>