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>