Project

General

Profile

Actions

Bug #16316

open

Unclear documentation in ixgbe.conf

Added by Rain P about 2 months ago. Updated about 2 months ago.

Status:
New
Priority:
Normal
Assignee:
-
Category:
-
Start date:
Due date:
% Done:

0%

Estimated time:
Difficulty:
Medium
Tags:
Gerrit CR:
External Bug:

Description

Hi --

I was trying to get illumos set up with an Intel X520 card, and came across this documentation: https://github.com/illumos/illumos-gate/blob/445784c00080f22524a1a4659cf8b7b2e1ad84d1/usr/src/uts/common/io/ixgbe/ixgbe.conf#L82-L96

The documentation states:

# Use the following command to find out the device paths for ixgbe,
#       more /etc/path_to_inst | grep ixgbe
#
# For example, if you see,
#    "/pci@7b,0/pci10de,5d@e/pci8086,a15f@0" 0 "ixgbe" 
#    "/pci@7b,0/pci10de,5d@e/pci8086,a15f@0,1" 1 "ixgbe" 
#
# name = "pciex8086,10c6" parent = "/pci@0,0/pci10de,\<pci10de\>5d@e" unit-address = "0" 
# flow_control = 1;
# name = "pciex8086,10c6" parent = "/pci@0,0/\<pci\>pci10de,5d@e" unit-address = "1" 
# flow_control = 3;
  1. Should the second "unit-address" be "0,1" rather than 0?
  2. The suggested replacement has \< and \> characters. The man page for driver.conf doesn't talk about any such documentation (https://illumos.org/man/5/driver.conf). Does this syntax have a special meaning?

Thank you!

Actions #1

Updated by Kimberly Mueller about 2 months ago

while the < and > characters in the documentation are likely used to denote literal characters, the specific numbering of unit addresses would depend on the actual configuration and behavior of the devices in question. It's important to refer to the documentation or specifications provided by the device manufacturer or system administrator for accurate information on device configuration.
lobotomy dash

Actions

Also available in: Atom PDF