From owner-svn-src-all@FreeBSD.ORG Fri Feb 24 07:00:29 2012 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CB516106564A; Fri, 24 Feb 2012 07:00:29 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id B91278FC22; Fri, 24 Feb 2012 07:00:29 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q1O70TwQ046677; Fri, 24 Feb 2012 07:00:29 GMT (envelope-from brueffer@svn.freebsd.org) Received: (from brueffer@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q1O70Txf046674; Fri, 24 Feb 2012 07:00:29 GMT (envelope-from brueffer@svn.freebsd.org) Message-Id: <201202240700.q1O70Txf046674@svn.freebsd.org> From: Christian Brueffer Date: Fri, 24 Feb 2012 07:00:29 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-9@freebsd.org X-SVN-Group: stable-9 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r232098 - stable/9/share/man/man4 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Feb 2012 07:00:30 -0000 Author: brueffer Date: Fri Feb 24 07:00:29 2012 New Revision: 232098 URL: http://svn.freebsd.org/changeset/base/232098 Log: MFC: r231880,r231915,r231937 Add a manpage for the oce(4) driver. Added: stable/9/share/man/man4/oce.4 - copied, changed from r231880, head/share/man/man4/oce.4 Modified: stable/9/share/man/man4/Makefile Directory Properties: stable/9/share/man/man4/ (props changed) Modified: stable/9/share/man/man4/Makefile ============================================================================== --- stable/9/share/man/man4/Makefile Fri Feb 24 05:40:36 2012 (r232097) +++ stable/9/share/man/man4/Makefile Fri Feb 24 07:00:29 2012 (r232098) @@ -328,6 +328,7 @@ MAN= aac.4 \ ${_nvram.4} \ ${_nvram2env.4} \ ${_nxge.4} \ + oce.4 \ ohci.4 \ orm.4 \ ${_padlock.4} \ Copied and modified: stable/9/share/man/man4/oce.4 (from r231880, head/share/man/man4/oce.4) ============================================================================== --- head/share/man/man4/oce.4 Fri Feb 17 14:02:44 2012 (r231880, copy source) +++ stable/9/share/man/man4/oce.4 Fri Feb 24 07:00:29 2012 (r232098) @@ -36,9 +36,7 @@ .\" .\" $FreeBSD$ .\" - - -.Dd February 14, 2012 +.Dd February 19, 2012 .Dt OCE 4 .Os .Sh NAME @@ -49,64 +47,85 @@ To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent +.Cd "device pci" .Cd "device oce" .Ed .Pp -To load the driver as a +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_oce_load="YES" .Ed .Sh DESCRIPTION -Emulex one connect adapters come in various skews and with +Emulex OneConnect adapters come in various skews and with different combinations of NIC, FCoE and iSCSI functions. -oce claims the NIC functions in all these adapters. +The +.Nm +driver claims the NIC functions in all these adapters. .Pp The .Nm driver supports VLAN Hardware offload, TCP checksum offload, TCP segmentation offload (TSO), Large receive offload (LRO), Bonding, Jumbo frames (from 1500 - 9000), Multiple TX queues, -Receive-Side Scaling(RSS) and MSI-X interrupts. +Receive-Side Scaling (RSS) and MSI-X interrupts. .Sh HARDWARE +The .Nm -driver supports the following Emulex network adapters: +driver supports the following network adapters: +.Pp .Bl -bullet -compact .It -BladeEngine 2 +Emulex BladeEngine 2 .It -BladeEngine 3 +Emulex BladeEngine 3 .It -Lancer +Emulex Lancer .El .Sh UPDATING FIRMWARE Adapter firmware updates are persistent. - +.Pp Firmware can be updated by following the steps below: -.nf - 1) Copy the below code to a Makefile - ".KMOD=elxflash - FIRMWS=imagename.ufi:elxflash - .include " - 2) Replace imagename in above with UFI file name. - 3) Copy Makefile and UFI to a directory - 4) Execute make & copy generated elxflash.ko to /lib/modules - 5) sysctl dev.oce..fw_upgrade=elxflash - 6) Reboot the machine. - +.Bl -enum +.It +Copy the below code to a Makefile: +.Pp +.Bd -literal -offset indent +\&.KMOD=elxflash +FIRMWS=imagename.ufi:elxflash +\&.include +.Ed +.It +Replace imagename in above with UFI file name +.It +Copy Makefile and UFI file to a directory +.It +Execute make & copy generated elxflash.ko to +.Pa /lib/modules +.It +sysctl dev.oce..fw_upgrade=elxflash +.It +Reboot the machine +.El +.Pp In case of issues with supplied UFI, flashing fails with one -of the below errors. - 1) "Invalid BE3 firmware image" - 2) "Invalid Cookie. Firmware image corrupted ?" - 3) "cmd to write to flash rom failed." -.fi +of the following errors. +.Pp +.Bl -enum -compact +.It +.Qq Invalid BE3 firmware image +.It +.Qq "Invalid Cookie. Firmware image corrupted ?" +.It +.Qq cmd to write to flash rom failed. +.El .Sh SUPPORT For general information and support, go to the Emulex website at: -.Fa http://www.Emulex.com/ -or E-Mail at -.Fa freebsd-drivers@emulex.com. +.Pa http://www.Emulex.com/ +or E-Mail at +.Pa freebsd-drivers@emulex.com . .Sh SEE ALSO .Xr ifconfig 8 .Sh AUTHORS @@ -114,4 +133,4 @@ or E-Mail at The .Nm driver was written by -.An freebsd-drivers@emulex.com. +.An freebsd-drivers@emulex.com .