hxge man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

hxge(7D)			    Devices			      hxge(7D)

NAME
       hxge - Sun Blade 10 Gigabit Ethernet network driver

SYNOPSIS
       /dev/hxge*

DESCRIPTION
       The  hxge  Gigabit Ethernet driver is a multi-threaded, loadable, clon‐
       able, GLD-based STREAMS driver supporting the Data Link Provider Inter‐
       face, dlpi(7P), on the Sun Blade Shared 10Gb Ethernet Interface.

       The  Shared PCI-Express 10 Gb networking interface provides network I/O
       consolidation for up to six Constellation blades, with each blade  see‐
       ing its own portion of the network interface.

       The  hxge  driver functions include chip initialization, frame transmit
       and receive, flow classification, multicast and promiscuous support and
       error recovery and reporting in the blade domain.

APPLICATION PROGRAMMING INTERFACE
       The cloning character-special device, /dev/hxge, is used	 to access Sun
       Blade Shared 10Gb Ethernet Interface devices installed within the  sys‐
       tem.

       The hxge driver is managed by the dladm(1M) command line utility, which
       allows VLANs to be defined on top  of  hxge   instances	and  for  hxge
       instances to be aggregated. See dladm(1M) for more details.

       You must send an explicit DL_ATTACH_REQ message to associate the opened
       stream with a particular device (PPA). The PPA ID is interpreted as  an
       unsigned	 integer  data	type  and  indicates  the corresponding device
       instance (unit) number. The driver returns an error  (DL_ERROR_ACK)  if
       the PPA field value does not correspond to a valid device instance num‐
       ber for the system. The device is initialized  on   first   attach  and
       de-initialized (stopped) at last detach

       The  values  returned  by  the  driver  in the DL_INFO_ACK primitive in
       response to a DL_INFO_REQ are:

	   o	  Maximum SDU is  1500	(ETHERMTU  -  defined  in  <sys/ether‐
		  net.h>).

	   o	  Minimum SDU is 0.

	   o	  DLSAP address length is 8.

	   o	  MAC type is DL_ETHER.

	   o	  SAP  length value is -2, meaning the physical address compo‐
		  nent is followed  immediately	 by  a	2-byte	SAP  component
		  within the DLSAP address.

	   o	  Broadcast  address  value  is	 the  Ethernet/IEEE  broadcast
		  address (FF:FF:FF:FF:FF:FF).

		  Due to the nature of the link address definition for	IPoIB,
		  the DL_SET_PHYS_ADDR_REQ DLPI primitive is not supported.

		  In  the  transmit case for streams that have been put in raw
		  mode via the	DLIOCRAW  ioctl,  the  dlpi  application  must
		  prepend the 20 byte IPoIB destination address to the data it
		  wants to transmit over-the-wire. In the receive case, appli‐
		  cations  receive  the	 IP/ARP	 datagram  along with the IETF
		  defined 4 byte header.

       Once in the DL_ATTACHED state, you must send a DL_BIND_REQ to associate
       a particular Service Access Point (SAP) with the stream.

CONFIGURATION
       The link speed and mode are fixed at 10 Gbps full-duplex.

       The  default  MTU is 1500. To enable jumbo frame support, you configure
       the hxge driver by defining the	accept-jumbo  property	to  1  in  the
       hxge.conf file. Note that the largest jumbo size is 9178 bytes.

       The  driver may be configured to discard certain classes of traffic. By
       default, no class of traffic is allowed. You configure the hxge	driver
       by  defining  the class option property to 0x20000 in hxge.conf to dis‐
       card the specified class of traffic. For example, the following line in
       hxge.conf discards all IP Version 4 TCP traffic:

	 class-opt-ipv4-tcp = 0x20000;

       You  can	 also  use the ndd(1M) command to configure the hxge driver at
       runtime to discard any classes of traffic.

       The hxgedriver supports the self-healing functionality of  Solaris  OS.
       By   default   it   is	configured  to	     DDI_FM_EREPORT_CAPABLE  |
       DDI_FM_ERRCB_CAPABLE. You configure the hxge driver by defining the fm-
       capable	property  in hxge.conf to other capabilities or to 0x0 to dis‐
       able it entirely.

       The hxge driver may be configured using the standard ifconfig(1M)  com‐
       mand.

       The  hxge  driver also reports various hardware and software statistics
       data. You can view these statistics using the kstat(1M) command.

FILES
       /dev/hxge*		   Special character device.

       /kernel/drv/hxge		   32-bit device driver (x86).

       /kernel/drv/sparcv9/hxge	   64-bit device driver (SPARC).

       /kernel/drv/amd64/hxge	   64-bit device driver (x86).

       /kernel/drv/hxge.conf	   Configuration file.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Architecture		     │SPARC, x86		   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       dladm(1M),    ifconfig(1M),    kstat(1M),     ndd(1M),	  netstat(1M),
       driver.conf(4), attributes(5), streamio(7I), dlpi(7P)

       Writing Device Drivers

       STREAMS Programming Guide

       Network Interfaces Programmer's Guide

SunOS 5.10			  10 Feb 2007			      hxge(7D)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net