xnb.4 (3e85ab1008d682f64a8857f52fd49f577d6478e8) xnb.4 (12afe06c06846b49eab319388a689123dd7860a4)
1.\" Copyright (c) 2012 Spectra Logic Corporation
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions, and the following disclaimer,

--- 70 unchanged lines hidden (view full) ---

79netfront and netback.
80Mostly useful for debugging, but can also be used to
81get traffic statistics.
82.It Va dev.xnb.%d.unit_test_results
83Runs a builtin suite of unit tests and displays the results.
84Does not affect the operation of the driver in any way.
85Note that the test suite simulates error conditions; this will result in
86error messages being printed to the system system log.
1.\" Copyright (c) 2012 Spectra Logic Corporation
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions, and the following disclaimer,

--- 70 unchanged lines hidden (view full) ---

79netfront and netback.
80Mostly useful for debugging, but can also be used to
81get traffic statistics.
82.It Va dev.xnb.%d.unit_test_results
83Runs a builtin suite of unit tests and displays the results.
84Does not affect the operation of the driver in any way.
85Note that the test suite simulates error conditions; this will result in
86error messages being printed to the system system log.
87.Sh SEE ALSO
88.Xr arp 4 ,
89.Xr netintro 4 ,
90.Xr ng_ether 4 ,
91.Xr xen 4 ,
92.Xr ifconfig 8
93.Sh HISTORY
94The
95.Nm
96device driver first appeared in
97.Fx 10.0 .
98.Sh AUTHORS
99The
100.Nm
101driver was written by
102.An Alan Somers
103.Aq alans@spectralogic.com
104and
105.An John Suykerbuyk
106.Aq johns@spectralogic.com
87.Sh CAVEATS
88Packets sent through Xennet pass over shared memory, so the protocol includes
89no form of link-layer checksum or CRC.
90Furthermore, Xennet drivers always report to their hosts that they support
91receive and transmit checksum offloading.
92They "offload" the checksum calculation by simply skipping it.
93That works fine for packets that are exchanged between two domains on the same
94machine.

--- 10 unchanged lines hidden (view full) ---

105to the OS.
106.Pp
107For this reason, it is recommended that if
108.Nm
109is bridged to a physcal interface, then transmit checksum offloading should be
110disabled on the netfront.
111The Xennet protocol does not have any mechanism for the netback to request
112the netfront to do this; the operator must do it manually.
107.Sh CAVEATS
108Packets sent through Xennet pass over shared memory, so the protocol includes
109no form of link-layer checksum or CRC.
110Furthermore, Xennet drivers always report to their hosts that they support
111receive and transmit checksum offloading.
112They "offload" the checksum calculation by simply skipping it.
113That works fine for packets that are exchanged between two domains on the same
114machine.

--- 10 unchanged lines hidden (view full) ---

125to the OS.
126.Pp
127For this reason, it is recommended that if
128.Nm
129is bridged to a physcal interface, then transmit checksum offloading should be
130disabled on the netfront.
131The Xennet protocol does not have any mechanism for the netback to request
132the netfront to do this; the operator must do it manually.
113.Sh SEE ALSO
114.Xr arp 4 ,
115.Xr netintro 4 ,
116.Xr ng_ether 4 ,
117.Xr xen 4 ,
118.Xr ifconfig 8
119.Sh HISTORY
120The
121.Nm
122device driver first appeared in
123.Fx 10.0 .
124.Sh AUTHORS
125The
126.Nm
127driver was written by
128.An Alan Somers
129.Aq alans@spectralogic.com
130and
131.An John Suykerbuyk
132.Aq johns@spectralogic.com
133.Sh BUGS
134The
135.Nm
136driver does not properly checksum UDP datagrams that span more than one
137Ethernet frame.
138Nor does it correctly checksum IPv6 packets.
139To workaround that bug, disable transmit checksum offloading on the
140netfront driver.
133.Sh BUGS
134The
135.Nm
136driver does not properly checksum UDP datagrams that span more than one
137Ethernet frame.
138Nor does it correctly checksum IPv6 packets.
139To workaround that bug, disable transmit checksum offloading on the
140netfront driver.