snp man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

SNP(4)			 BSD Kernel Interfaces Manual			SNP(4)

NAME
     snp — tty snoop interface

SYNOPSIS
     #include <sys/snoop.h>

     int
     ioctl(fd, SNPSTTY, &dev);

     int
     ioctl(fd, SNPGTTY, &dev);

     int
     ioctl(fd, FIONREAD, &result);

DESCRIPTION
     /dev/snp is a snoop device which allows users to attach to any tty and
     watch activities on it.  The kernel must be compiled with device snp, or
     the snp module must be loaded, for these devices to be available.

     To associate a given snp device with a tty to be observed, open the snp
     device and a tty device, and then issue the SNPSTTY ioctl on snp device.
     The argument passed to the ioctl(2) is the address of a variable of type
     int, holding the file descriptor of a tty device.	To detach the snp
     device from a tty use a pointer to a value of -1.

     The SNPGTTY ioctl returns information about the current tty attached to
     the open snp device.

     The FIONREAD ioctl returns a positive value equal to the number of char‐
     acters in a read buffer.  Special values defined are:

     SNP_OFLOW	   device overflow occurred, device detached.

     SNP_TTYCLOSE  tty not attached.

     SNP_DETACH	   snp device has been detached by user or tty device has been
		   closed and detached.

SEE ALSO
     pty(4), sio(4), kldload(8), watch(8)

HISTORY
     The snp device first appeared in FreeBSD 2.1.  In FreeBSD 8.0 the snp
     driver was rewritten to work with the replaced TTY subsystem.

AUTHORS
     The author of the current implementation is Ed Schouten ⟨ed@FreeBSD.org⟩.
     Previous versions of snp were based on code written by
     Ugen J.S. Antsilevich ⟨ugen@NetVision.net.il⟩.

BUGS
     This version of snp does not return proper error codes when calling
     FIONREAD.	It also does not allow SNPSTTY to detach itself from the TTY.

BSD			       November 5, 2008				   BSD
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net