fkey ver. 0.1a -- permits remote triggering of F-key actions  
author: Al Woodhull <awoodhull@hampshire.edu>   5 December 1999

Fkey sends one of the custom ioctls TFKEY1, TFKEY2, ..., or TFKEY5 to
the terminal task.  Upon receipt of one of these ioctls the terminal
task calls the function that would be called if F1, F2, ..., or F5 were
pressed on the local keyboard.  Since the output of these dumps goes
only to the console screen, screendump (8) is invoked to send the
console screen contents to stdout.

Currently these F-key functions are available:
  F1: display process table
  F2: display details of user processes
  F3: toggle software/hardware scrolling
  F5: show ethernet statistics

To take advantage of this the kernel must be compiled with special
versions of /usr/include/sys/ioctl.h, in which the new ioctls are
defined, and /usr/src/kernel/tty.c, in which the actions of the new
ioctls are defined.

Installation:
Make a directory /usr/local/src/fkey and unpack the archive there. 

Modify the ioctl definitions which will be needed to compile fkey
and the new kernel that interacts with fkey:
  patch -p0 < ioctl.hdiff

Make and install the program:
  make fkey
  su
  make install

Make install puts the man page in /usr/local/man/man8.  If you do not
already have an fkey.8 page here you need to run "makewhatis
/usr/local/man" to make the new man page visible to the man command.
  
Now make a modified kernel:
  patch -p0 < tty.cdiff 
  cd /usr/src/tools
  make hdboot (or make fdboot)

Save the old files /usr/include/sys/ioctl.h~ and /usr/src/kernel/tty.c~
so you can easily rebuild a standard kernel without the new ioctls.

Use:
You must be root to use fkey.
  fkey 1
will have the same effect as pressing F1 at the main console, except the 
contents of the main console screen will also be dumped on stdout. In 
version 0.1 valid arguments are  1 through 5.

(rev 2002-12-02)