| netgraph.4 (73233) | netgraph.4 (75531) |
|---|---|
| 1.\" Copyright (c) 1996-1999 Whistle Communications, Inc. 2.\" All rights reserved. 3.\" 4.\" Subject to the following obligations and disclaimer of warranty, use and 5.\" redistribution of this software, in source or object code forms, with or 6.\" without modifications are expressly permitted by Whistle Communications; 7.\" provided, however, that: 8.\" 1. Any and all reproductions of the source or object code must include the --- 19 unchanged lines hidden (view full) --- 28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY 31.\" OF SUCH DAMAGE. 32.\" 33.\" Authors: Julian Elischer <julian@FreeBSD.org> 34.\" Archie Cobbs <archie@FreeBSD.org> 35.\" | 1.\" Copyright (c) 1996-1999 Whistle Communications, Inc. 2.\" All rights reserved. 3.\" 4.\" Subject to the following obligations and disclaimer of warranty, use and 5.\" redistribution of this software, in source or object code forms, with or 6.\" without modifications are expressly permitted by Whistle Communications; 7.\" provided, however, that: 8.\" 1. Any and all reproductions of the source or object code must include the --- 19 unchanged lines hidden (view full) --- 28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY 31.\" OF SUCH DAMAGE. 32.\" 33.\" Authors: Julian Elischer <julian@FreeBSD.org> 34.\" Archie Cobbs <archie@FreeBSD.org> 35.\" |
| 36.\" $FreeBSD: head/share/man/man4/netgraph.4 73233 2001-02-28 17:38:53Z ru $ | 36.\" $FreeBSD: head/share/man/man4/netgraph.4 75531 2001-04-15 19:53:47Z dd $ |
| 37.\" $Whistle: netgraph.4,v 1.7 1999/01/28 23:54:52 julian Exp $ 38.\" 39.Dd January 19, 1999 40.Dt NETGRAPH 4 41.Os FreeBSD 42.Sh NAME 43.Nm netgraph 44.Nd graph based kernel networking subsystem --- 301 unchanged lines hidden (view full) --- 346This method allows a node to clean up 347and to ensure that any actions that need to be performed 348at this time are taken. The method is called by the generic (i.e., superclass) 349node destructor which will get rid of the generic components of the node. 350Some nodes (usually associated with a piece of hardware) may be 351.Em persistent 352in that a shutdown breaks all edges and resets the node, 353but doesn't remove it. In this case the shutdown method should not | 37.\" $Whistle: netgraph.4,v 1.7 1999/01/28 23:54:52 julian Exp $ 38.\" 39.Dd January 19, 1999 40.Dt NETGRAPH 4 41.Os FreeBSD 42.Sh NAME 43.Nm netgraph 44.Nd graph based kernel networking subsystem --- 301 unchanged lines hidden (view full) --- 346This method allows a node to clean up 347and to ensure that any actions that need to be performed 348at this time are taken. The method is called by the generic (i.e., superclass) 349node destructor which will get rid of the generic components of the node. 350Some nodes (usually associated with a piece of hardware) may be 351.Em persistent 352in that a shutdown breaks all edges and resets the node, 353but doesn't remove it. In this case the shutdown method should not |
| 354free it's resources, but rather, clean up and then clear the | 354free its resources, but rather, clean up and then clear the |
| 355.Em NG_INVALID 356flag to signal the generic code that the shutdown is aborted. In 357the case where the shutdown is started by the node itself due to hardware 358removal or unloading, (via ng_rmnode_self()) it should set the 359.Em NG_REALLY_DIE | 355.Em NG_INVALID 356flag to signal the generic code that the shutdown is aborted. In 357the case where the shutdown is started by the node itself due to hardware 358removal or unloading, (via ng_rmnode_self()) it should set the 359.Em NG_REALLY_DIE |
| 360flag to signal to it's own shutdown method that it is not to persist. | 360flag to signal to its own shutdown method that it is not to persist. |
| 361.El 362.Sh Sending and Receiving Data 363Two other methods are also supported by all nodes: 364.Bl -tag -width xxx 365.It Receive data message 366A 367.Em Netgraph queueable reqest item , 368usually refered to as an --- 53 unchanged lines hidden (view full) --- 422.Nm 423NETISR system (see below). It achieves this by setting the 424.Dv HK_QUEUE 425flag in the flags word of the hook on which that data will arrive. 426The infrastructure will respect that bit and queue the data for delivery at 427a later time, rather than deliver it directly. A node may decide to set 428the bit on the 429.Em peer | 361.El 362.Sh Sending and Receiving Data 363Two other methods are also supported by all nodes: 364.Bl -tag -width xxx 365.It Receive data message 366A 367.Em Netgraph queueable reqest item , 368usually refered to as an --- 53 unchanged lines hidden (view full) --- 422.Nm 423NETISR system (see below). It achieves this by setting the 424.Dv HK_QUEUE 425flag in the flags word of the hook on which that data will arrive. 426The infrastructure will respect that bit and queue the data for delivery at 427a later time, rather than deliver it directly. A node may decide to set 428the bit on the 429.Em peer |
| 430node, so that it's own output packets are queued. This is used | 430node, so that its own output packets are queued. This is used |
| 431by device drivers running at different processor priorities to transfer 432packet delivery to the splnet() level at which the bulk of 433.Nm 434runs. 435.Pp 436The structure and use of meta-data is still experimental, but is 437presently used in frame-relay to indicate that management packets 438should be queued for transmission --- 935 unchanged lines hidden --- | 431by device drivers running at different processor priorities to transfer 432packet delivery to the splnet() level at which the bulk of 433.Nm 434runs. 435.Pp 436The structure and use of meta-data is still experimental, but is 437presently used in frame-relay to indicate that management packets 438should be queued for transmission --- 935 unchanged lines hidden --- |