freebsd-skq

History

Robert Watson a152f8a361 Change semantics of socket close and detach. Add a new protocol switch function, pru_close, to notify protocols that the file descriptor or other consumer of a socket is closing the socket. pru_abort is now a notification of close also, and no longer detaches. pru_detach is no longer used to notify of close, and will be called during socket tear-down by sofree() when all references to a socket evaporate after an earlier call to abort or close the socket. This means detach is now an unconditional teardown of a socket, whereas previously sockets could persist after detach of the protocol retained a reference. This faciliates sharing mutexes between layers of the network stack as the mutex is required during the checking and removal of references at the head of sofree(). With this change, pru_detach can now assume that the mutex will no longer be required by the socket layer after completion, whereas before this was not necessarily true. Reviewed by: gnn		2006-07-21 17:11:15 +00:00
..
ipx_cksum.c	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
ipx_if.h	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
ipx_input.c	Canonicalize copyright order in one more file that contains my	2006-03-27 01:12:58 +00:00
ipx_ip.c	Include kernel.h to get NET_NEEDS_GIANT() definition, which for some	2006-03-24 20:08:48 +00:00
ipx_ip.h	Stop embedding struct ifnet at the top of driver softcs. Instead the	2005-06-10 16:49:24 +00:00
ipx_outputfl.c	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
ipx_pcb.c	Rework IPX/SPX socket and pcb reference model:	2006-03-25 17:28:42 +00:00
ipx_pcb.h	Add a new ipxpcb flag, IPXP_SPX, which is set on ipxpcb's to mark them	2006-03-26 15:41:44 +00:00
ipx_proto.c	Use sparse initializers for "struct domain" and "struct protosw",	2005-11-09 13:29:16 +00:00
ipx_usrreq.c	Change semantics of socket close and detach. Add a new protocol switch	2006-07-21 17:11:15 +00:00
ipx_var.h	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
ipx.c	Recent changes have locked down most of the highly dynamic data	2005-01-09 05:34:37 +00:00
ipx.h	Back out ipx.h:1.18, which introduced a Linux API compatibility field in	2005-05-27 12:25:42 +00:00
README	Add a simple netipx TODO list to the end of README, since there are a	2006-03-27 09:10:09 +00:00
spx_debug.c	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
spx_debug.h	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
spx_timer.h	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
spx_usrreq.c	Change semantics of socket close and detach. Add a new protocol switch	2006-07-21 17:11:15 +00:00
spx_var.h	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00
spx.h	/* -> /*- for license, minor formatting changes	2005-01-07 01:45:51 +00:00

README

$FreeBSD$

This protocol implements IPX/SPX over Ethernet_II frame type 0x8137.
Please note: the SPX implementation may require further work and testing
to insure proper operation.

Mike Mitchell, Network Engineer
AMTECH Systems Corporation, Technology and Manufacturing
8600 Jefferson Street, Albuquerque, New Mexico 87113 (505) 856-8000
supervisor@alb.asctmd.com

John Hay
Some Company
Some Address
jhay@mikom.csir.co.za

Adapted for multi-processor, multi-threaded network stack by Robert N. M.
Watson, Computer Laboratory, University of Cambridge.

--- Copyright Information ---
/*-

Copyright (c) 1984, 1985, 1986, 1987, 1993
The Regents of the University of California.  All rights reserved.

Modifications Copyright (c) 1995, Mike Mitchell
Modifications Copyright (c) 1995, John Hay
Modifications Copyright (c) 2004-2006 Robert N. M. Watson

*/

--- TODO ---

(1) netipx default socket buffer sizes are very small by contemporary
    standards, and should be increased following testing and measurement.

(2) SPX will free the PCB and socket buffer memory on close(), which means
    close() in effects terminates the transfer of any outstanding buffered
    but unsent data.  As with TCP, it should instead grab its own
    reference to the socket so that it is not released, as hold onto it
    until the data transfer is complete.

(3) Raw socket capture of IPX output intercepts packets in the SPX output
    routine in order to feed them back into the raw socket.  This results
    in recursion into the socket code in the transmit path; instead,
    captured packets should be fed into a netisr that reinjects them into
    raw sockets from a new (asynchronous) context.

(4) IPX over IP encapsulation needs work to make it properly MPSAFE.