ng_hole (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_hole.4freebsd".)

NAME

ng_hole - netgraph discard node type

SYNOPSIS

In sys/types.h In netgraph/ng_hole.h

DESCRIPTION

The hole node type silently discards all data and control messages it receives. This type is used for testing and debugging.

HOOKS

A ifconfig node accepts any request to connect, regardless of the hook name, as long as the name is unique.

CONTROL MESSAGES

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

NGM_HOLE_GET_STATS (getstats )

This command takes an ASCII string argument, the hook name, and returns the statistics associated with the hook as a Vt struct ng_hole_hookstat .

NGM_HOLE_CLR_STATS (clrstats )

This command takes an ASCII string argument, the hook name, and clears the statistics associated with the hook.

NGM_HOLE_GETCLR_STATS (getclrstats )

This command is identical to NGM_HOLE_GET_STATS except that the statistics are also atomically cleared.

SHUTDOWN

This node shuts down upon receipt of a NGM_SHUTDOWN control message, or when all hooks have been disconnected.

SEE ALSO

netgraph(4), ng_echo4, ngctl(8)

HISTORY

The ifconfig node type was implemented in Fx 4.0 .

AUTHORS

An Julian Elischer Aq julian@FreeBSD.org