GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SNP (4)

NAME

snp - tty snoop interface

CONTENTS

Synopsis
Description
See Also
History
Authors
Bugs

SYNOPSIS


.In 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
.Cd 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
.Vt 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 characters 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
.Fx 2.1 . In
.Fx 8.0 the snp driver was rewritten to work with the replaced TTY subsystem.

AUTHORS

The author of the current implementation is
.An Ed Schouten Aq ed@FreeBSD.org . Previous versions of snp were based on code written by
.An Ugen J.S. Antsilevich Aq 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.
Search for    or go to Top of page |  Section 4 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.