watch(8) [freebsd man page]

WATCH(8)						    BSD System Manager's Manual 						  WATCH(8)

NAME

     watch -- snoop on another tty line

SYNOPSIS

     watch [-cinotW] [-f snpdev] [tty]

DESCRIPTION

     The watch utility allows the user to examine all data coming through a specified tty using the snp(4) device.  If the snp(4) device is not
     available, watch will attempt to load the module (snp).  The watch utility writes to standard output.

     The options are as follows:

     -c      Reconnect on close.  If the tty observed by watch is closed, automatically reattach to the same tty.  If this option is not speci-
	     fied, watch will request a new tty if running in interactive mode or exit if running without a controlling tty.

     -f snpdev
	     If this option is specified, watch will use snpdev as the snp(4) device.  Without this option, watch will attempt to find the next
	     available snp(4) device.

     -i      Force interactive mode.  Interactive mode is a default if watch is started from a tty.  If output is redirected to a file, interac-
	     tive mode can still be requested by specifying this option.

     -n      Disable the ability to switch the watched tty interactively.  This disables both change requests made with <control-X> as well as
	     automatic prompting when the current tty is closed or overflows.  In all cases where a prompt would be displayed, watch will exit.
	     The reconnect flags are unaffected by this option.  When this flag is used, <control-X> is passed through to the terminal.

     -o      Reconnect on overflow.  The behavior of watch if the observed tty overflows is similar to the behavior if the observed tty is closed.
	     For more info see snp(4).

     -t      Print the date and time when observation of a given tty is started.

     -W      Allow write access to observed tty.

     tty     Tty may be specified as a tty-style device, such as a pseudo tty device, a virtual console, or a serial line, etc.  Names may be pre-
	     ceded by /dev/.

OPERATION

     While running in interactive mode, all user input is discarded except for:

     <control-G>
	   Exit watch.
     <control-W>
	   Clear screen.
     <control-X>
	   Change attached tty, unless this feature is disabled, in which case control-X is passed to the terminal as with other control charac-
	   ters.

SEE ALSO

     pty(4), sio(4), snp(4), kldload(8)

HISTORY

     The watch utility first appeared in FreeBSD 2.1.

AUTHORS

     Ugen J.S. Antsilevich <ugen@NetVision.net.il>

BUGS

     No terminal emulation is performed.  All user output is reproduced as-is.

BSD
								 November 24, 2001							       BSD

TTYSNOOP(8)						    BSD System Manager's Manual 					       TTYSNOOP(8)

NAME

     ttysnoop -- snoop on a user's tty

SYNOPSIS

     ttysnoop [pty]
     ttysnoops

DESCRIPTION

     The ttysnoop / ttysnoops client-server combo can be used to snoop (watch) on a user's login tty.  The server (ttysnoops) is usually started
     by getty(8) or telnetd(8) and reads the file /etc/snooptab to find out which tty's should be cloned and which programs to run on them (usu-
     ally /bin/login). A tty may be snooped through a pre-determined (ie.  fixed) device, or through a dynamically allocated pseudo-tty (pty).
     This is also specified in the /etc/snooptab file. To connect to the pty, the client ttysnoop should be used. The available pseudo terminals
     pty are present as sockets in the directory /var/spool/ttysnoop/.

   Format of /etc/snooptab
     The /etc/snooptab file may contain comment lines (starting with a '#'), empty lines, or entries for tty's that should be snooped upon. The
     format of such an entry is as follows:

	   tty	 snoop-device	type   program

     where tty is the leaf-name of the tty that should be snooped upon (eg. ttyS2, not /dev/ttyS2) OR the wildcard '*', which matches ANY tty.
     snoop-device is the device through which tty should be snooped (eg. /dev/tty8) OR the literal constant "socket". The latter is used to tell
     ttysnoops that the snoop-device will be a dynamically allocated pty.  type specifies the type of program that should be run, currently recog-
     nized types are "init", "user" and "login" although the former two aren't really needed. Finally, program is the full pathname to the program
     to run when ttysnoops has cloned tty onto snoop-device.

EXAMPLE

     The following example /etc/snooptab file should illustrate the typical use of ttysnoop / ttysnoops:

	    #
	    # example /etc/snooptab
	    #
	    ttyS0    /dev/tty7	  login    /bin/login
	    ttyS1    /dev/tty8	  login    /bin/login
	    #
	    # the wildcard tty should always be the last one in the file
	    #
	    *	     socket	  login    /bin/login
	    #
	    # example end
	    #

     With the above example, whenever a user logs in on /dev/ttyS0 or /dev/ttyS1, either tty will be snooped through /dev/tty7 or /dev/tty8
     respectively. Any other tty's will be snooped through a pty that will be allocated at the time of login. The system-administrator can then
     run ttysnoop pty to snoop through the pty. Note that it is up to the system-administrator to setup getty and/or telnetd so that they execute
     ttysnoops instead of /bin/login.

SEE ALSO

     getty(8), telnetd(8)

FILES

     /etc/snooptab

BUGS

     The program is unable to do any terminal control-code translations for the original tty and the snoop-device. I doubt it will ever do this.

AUTHOR

     Carl Declerck, carl@miskatonic.inbe.net

BSD
								   August 8 1994							       BSD