Changeset View
Standalone View
share/man/man4/sume.4
Property | Old Value | New Value |
---|---|---|
svn:eol-style | null | native \ No newline at end of property |
svn:keywords | null | FreeBSD=%H \ No newline at end of property |
svn:mime-type | null | text/plain \ No newline at end of property |
.\"- | |||||
.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD | |||||
rgrimes: This file is missing copyright, license and $FreeBSD$. | |||||
.\" | |||||
.\" Copyright (c) 2020 Denis Salopek | |||||
.\" | |||||
.\" Redistribution and use in source and binary forms, with or without | |||||
Done Inline ActionsSince you just wrote this man page how is it possible to have a copyright from Cambridge or BZ, and especially from 2015? Or was some of this text from a linux file? rgrimes: Since you just wrote this man page how is it possible to have a copyright from Cambridge or BZ… | |||||
.\" modification, are permitted provided that the following conditions | |||||
Done Inline ActionsThe "All rights reserved" formula is obsolete and can and could be ommited, especially in freshly created files zec: The "All rights reserved" formula is obsolete and can and could be ommited, especially in… | |||||
.\" are met: | |||||
.\" 1. Redistributions of source code must retain the above copyright | |||||
.\" notice, this list of conditions and the following disclaimer. | |||||
.\" 2. Redistributions in binary form must reproduce the above copyright | |||||
.\" notice, this list of conditions and the following disclaimer in the | |||||
.\" documentation and/or other materials provided with the distribution. | |||||
.\" | |||||
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |||||
.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE | |||||
.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | |||||
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | |||||
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | |||||
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | |||||
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | |||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |||||
.\" POSSIBILITY OF SUCH DAMAGE. | |||||
.\" | |||||
.\" $FreeBSD$ | |||||
.\" | |||||
.Dd August 18, 2020 | |||||
.Dt SUME 4 | |||||
.Os | |||||
.Sh NAME | |||||
Done Inline Actionsman pages usually have a line break at full stops per style guide (full stop == period), This is done to ease future edits. rgrimes: man pages usually have a line break at full stops per style guide (full stop == period), This… | |||||
Done Inline Actions
This has not been done, the text is still flowed to fill margins, which is not the normal form for man pages. rgrimes: > man pages usually have a line break at full stops per style guide (full stop == period)… | |||||
Done Inline ActionsIs this fixed now? denissal: Is this fixed now? | |||||
Done Inline ActionsNot really, but this is not a blocking issue. rgrimes: Not really, but this is not a blocking issue. | |||||
.Nm sume | |||||
.Nd "NetFPGA SUME 4x10Gb Ethernet driver" | |||||
.Sh SYNOPSIS | |||||
Done Inline ActionsNeither Stanford nor UCAM have authored this manpage, so this paragraph should be removed. zec: Neither Stanford nor UCAM have authored this manpage, so this paragraph should be removed. | |||||
To compile this driver into the kernel, place the following lines | |||||
in your kernel configuration file: | |||||
.Bd -ragged -offset indent | |||||
.Cd "device sume" | |||||
Done Inline Actions"me" should probably not be in a man page. rgrimes: "me" should probably not be in a man page. | |||||
.Ed | |||||
.Pp | |||||
Alternatively, to load the driver as a module at boot time, place | |||||
the following line in | |||||
.Xr loader.conf 5 : | |||||
.Bd -literal -offset indent | |||||
if_sume_load="YES" | |||||
.Ed | |||||
.Sh DESCRIPTION | |||||
The | |||||
.Nm | |||||
driver provides support for NetFPGA SUME Virtex-7 FPGA Development Board | |||||
with the reference NIC bitstream loaded onto it. | |||||
The HDL design for the reference NIC project uses the RIFFA based DMA | |||||
engine to communicate with the host machine over PCIe. | |||||
Every packet is transmitted to / from the board via a DMA transaction, | |||||
zecUnsubmitted Done Inline ActionsInsert "single" before "DMA transaction", to clarify the inefficiency of the reference NIC DMA design and the huge PIO PCI traffic overhead (to set up the DMA) associated with each packet transfer. zec: Insert "single" before "DMA transaction", to clarify the inefficiency of the reference NIC DMA… | |||||
taking up to two or three interrupts per one transaction which yields in | |||||
zecUnsubmitted Done Inline ActionsDrop "in" after "yields", I don't think it is necessary. zec: Drop "in" after "yields", I don't think it is necessary. | |||||
low performance. | |||||
.Pp | |||||
There is no support for Jumbo frames as the hardware is capable of | |||||
dealing only with frames with maximum size of 1514 bytes. | |||||
Done Inline ActionsDouble use of original does not read well here. I would just drop the first one, as it is implied by the second one. rgrimes: Double use of original does not read well here. I would just drop the first one, as it is… | |||||
.Pp | |||||
The hardware provides no checksums and offers no other offloading. | |||||
zecUnsubmitted Done Inline ActionsThere's also no support for multicast filters... zec: There's also no support for multicast filters... | |||||
.Sh SEE ALSO | |||||
.Xr arp 4 , | |||||
.Xr netgraph 4 , | |||||
Done Inline Actionss/Cambridge/the NetFPGA project/ bz: s/Cambridge/the NetFPGA project/ | |||||
.Xr netintro 4 , | |||||
.Xr ng_ether 4 , | |||||
.Xr vlan 4 , | |||||
.Xr ifconfig 8 | |||||
.Sh AUTHORS | |||||
The Linux | |||||
.Nm | |||||
driver was originally written by | |||||
.An -nosplit | |||||
.An Bjoern A. Zeeb . | |||||
The | |||||
.Fx version and this manual page were written by | |||||
.An Denis Salopek | |||||
as a GSoC project. | |||||
More information about the project can be found here: | |||||
.Pa https://wiki.freebsd.org/SummerOfCode2020Projects/NetFPGA_SUME_Driver | |||||
.Sh BUGS | |||||
Pre-built bitstream from the NetFPGA project may not work correctly - at | |||||
higher RX packet rates, the newly incoming packets would overwrite the | |||||
ones in some internal FIFO so the packets would come out of the board | |||||
scrambled until physical reset of the board. | |||||
.Pp | |||||
There is also a strange behaviour in the TX path: when sending "small" | |||||
packets, TX works as it should, but when sending packets above some size | |||||
limit right after loading the driver, SUME does not send the TX_DONE | |||||
interrupt and refuses to send packets until the driver is reloaded or | |||||
the board is reset. | |||||
This would mean that the driver would get stuck in a non-IDLE TX state | |||||
but a watchdog-like function is implemented in the driver to check | |||||
whether the non-IDLE state lasts more then 3 seconds and it resets the | |||||
board automatically. | |||||
Done Inline ActionsChange in tense from past to present (was in last sentence, is in this sentence), the "is" should be changed to a "was". rgrimes: Change in tense from past to present (was in last sentence, is in this sentence), the "is"… | |||||
zecUnsubmitted Done Inline ActionsHaving played with the driver over the past few days, it would always successfully recover from rare glitches (presumably in FPGA logic(. Hence, I'm curious whether this comment is still valid and needed, and if not, I'd vote for removing it, or at least to trim it down and simply say that . I think it would be more important to notify users about the current FPGA design's inability to stop physical ports which have been configured as DOWN from consuming PCI / memory bandwidth, interrupts and CPU cycles, and that there's absolutely noting we can do about it in the driver. zec: Having played with the driver over the past few days, it would always successfully recover from… | |||||
For more details, visit the NetFPGA SUME project site. |
This file is missing copyright, license and $FreeBSD$.