ng_tee (4)

Leading comments

Copyright (c) 1996-1999 Whistle Communications, Inc.
All rights reserved.

Subject to the following obligations and disclaimer of warranty, use and
redistribution of this software, in source or object code forms, with or
without modifications are expressly permitted by Whistle Communications;
provided, however, that:
1. Any and all reproductions of the source or object code must include the
   copyright notice above and the following disclaimer of warranties; and
2. No rights are granted, in ...

(The comments found at the beginning of the groff file "man4/ng_tee.4freebsd".)

NAME

ng_tee - netgraph ``tee'' node type

SYNOPSIS

In sys/types.h In netgraph/ng_tee.h

DESCRIPTION

The tee node type has a purpose similar to the tee(1) command. Tee nodes are useful for debugging or ``snooping'' on a connection between two netgraph nodes. Tee nodes have four hooks, right left right2left and left2right All data received on right is sent unmodified to both hooks left and right2left Similarly, all data received on left is sent unmodified to both right and left2right

Packets may also be received on right2left and left2right if so, they are forwarded unchanged out hooks right and left respectively.

HOOKS

This node type supports the following hooks:

right

The connection to the node on the right.

left

The connection to the node on the left.

right2left

Tap for right to left traffic.

left2right

Tap for left to right traffic.

CONTROL MESSAGES

This node type supports the generic control messages, plus the following.

NGM_TEE_GET_STATS (getstats )

Get statistics, returned as a struct ng_tee_stats

NGM_TEE_CLR_STATS (clrstats )

Clear statistics.

SHUTDOWN

This node shuts down upon receipt of an NGM_SHUTDOWN control message, or when all hooks have been disconnected. If both right and left hooks are present, node removes itself from the chain gently, connecting right and left together.

SEE ALSO

tee(1), netgraph(4), ngctl(8)

HISTORY

The ifconfig node type was implemented in Fx 4.0 .

AUTHORS

An Julian Elischer Aq julian@FreeBSD.org