Intel PCI User Manual

Page of 54
GigMAC-PMC and PCI 
GigPMC Switch  
 
Board and Driver Users Manual 
DSS NETWORKS, INC. 
Version: 2.6 
  Page: 45 
10.3.11 SWITCH STATUS SHOW FUNCTION 
 
Note: This function is applicable for Model 5468 GigPMC and Model 6468 GigPCIe 
switch/interface cards only. 
 
 
vxWorks usage: 
 
inShowSwitch(unit) 
# unit = device index starting from 0 
 
Linux usage: 
 
./dmUtil –sw eth1  
# eth1, eth2, etc. 
 
 
Command output: 
 
-> inShowSwitch 
 
 unit: 0, switch link sts: 0x39, rctl: 0x1 
 
  link: 0, upFlg: 1 (UP) 
  link: 1, upFlg: 0 (DOWN) 
  link: 2, upFlg: 0 (DOWN) 
  link: 3, upFlg: 1 (UP) 
  link: 4, upFlg: 1 (UP) 
  link: 5, upFlg: 1 (UP) 
  link: 6, upFlg: 0 (DOWN) 
  link: 7, upFlg: 0 (DOWN) 
 
 
10.4 DPM DRIVER MANAGEMENT API 
 
The dpm network driver management API is an api extension primarily used by the 
‘dmUtil’ command line utility to enable various management functions or to acquire 
driver status and statistics. The typical api usage sequence is as follows: 
 
1.  User enters ‘dmUtil’ command and parameters as shown in the following 
example: 
./dmUtil –s eth1 
 
2.  dmUtil parses command line and prepares an “ioctl” request block to send to 
driver. A pointer to a application buffer to hold the text message results (for 
example formatted statistics) is provided by dmUtil in the request block. 
 
3.  Driver receives ioctl request block performs action and copies result data to 
applications message buffer. 
 
The following is an API description of the management ioctl commands issued to the 
driver from the ‘dmUtil’ application’s viewpoint: