1 PCN(7D) Devices PCN(7D) 2 3 4 5 6 7 NAME 8 pcn - PCnet Ethernet device driver 9 10 SYNOPSIS 11 /dev/pcn 12 13 14 DESCRIPTION 15 The pcn driver is a multi-threaded, loadable, clonable GLDv3-based 16 STREAMS driver supporting the Data Link Provider Interface dlpi(7P) for 17 the AMD PCnet family of Ethernet controllers. 18 19 APPLICATION PROGRAMMING INTERFACE 20 The pcn driver can be used as either a "style 1" or a "style 2" Data 21 Link Service Provider. Physical points of attachment (PPAs) are 22 interpreted as the instance number of the pcn controller as assigned by 23 the operating environment. 24 25 26 The values returned by the driver in the DL_INFO_ACK response are: 27 28 o Maximum SDU is 1500. 29 30 o Minimum SDU is 0. 31 32 o The dlsap address length is 8. 33 34 o MAC type is DL_ETHER. 35 36 o SAP length is -2. The 6-byte physical address is immediately 37 followed by a 2-byte SAP. 38 39 o Service mode is DL_CLDLS. 40 41 o The broadcast address is the 6-byte Ethernet broadcast 42 address (ff:ff:ff:ff:ff:ff). 43 44 CONFIGURATION 45 The pcn driver performs auto-negotiation to select the link speed and 46 mode. Link speed may be 100Mbps full-duplex, 100Mbps half-duplex, 47 10Mbps full-duplex, or 10Mbps half-duplex, depending on the hardware 48 adapter type. See the IEEE802.3 standard for more information. 49 50 51 The capabilities advertised by the pcn device can be set using 52 dladm(1m). The driver supports a number of parameters whose names 53 begin with en_ (see below). Each of these parameters contains a 54 boolean value that determines if the device advertises that mode of 55 operations. The adv_autoneg_cap parameter controls whether auto- 56 negotiation is performed. If adv_autoneg_cap is set to 0, the driver 57 forces the mode of operation selected by the first non-zero parameter 58 in priority order as shown below: 59 60 (highest priority/greatest throughput) 61 en_100fdx_cap 100Mbps full duplex 62 en_10fdx_cap 10Mbps full duplex 63 (lowest priority/least throughput) 64 65 66 67 All capabilities default to enabled. Note that changing any capability 68 parameter causes the link to go down while the link partners 69 renegotiate the link speed/duplex using the newly changed capabilities. 70 71 ATTRIBUTES 72 See attributes(5) for a description of the following attributes: 73 74 75 76 77 +--------------------+-----------------+ 78 | ATTRIBUTE TYPE | ATTRIBUTE VALUE | 79 +--------------------+-----------------+ 80 |Architecture | x86 | 81 +--------------------+-----------------+ 82 |Interface Stability | Committed | 83 +--------------------+-----------------+ 84 85 FILES 86 /dev/pcn 87 88 Special character device. 89 90 91 /kernel/drv/amd64/pcn 92 93 Device driver (x86) 94 95 96 SEE ALSO 97 attributes(5), streamio(7I), dlpi(7p) 98 99 100 IEEE 802.3 -- Institute of Electrical and Electronics Engineers, 2002 101 102 103 104 January 10, 2020 PCN(7D)