1
.\" Hey, EMACS: -*- nroff -*-
2
.\" First parameter, NAME, should be all caps
3
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4
.\" other parameters are allowed: see man(7), man(1)
5
.TH BIOSDEVNAME 1 "Nov 28, 2010"
6
.\" Please adjust this date whenever revising the manpage.
8
.\" Some roff macros, for reference:
9
.\" .nh disable hyphenation
10
.\" .hy enable hyphenation
11
.\" .ad l left justify
12
.\" .ad b justify to both left and right margins
13
.\" .nf disable filling
14
.\" .fi enable filling
15
.\" .br insert line break
16
.\" .sp <n> insert n+1 empty lines
17
.\" for manpage-specific macros, see man(7)
19
biosdevname \- give BIOS-given name of a device
22
.RI [options]\ [args]...
24
biosdevname takes a kernel device name as an
25
argument, and returns the BIOS-given name it "should" be.
29
Treat [args] as ethernet devs
34
.B \-\-policy \fI[physical|all_ethN]
36
.B \-\-prefix \fI[string]
37
string use for embedded NICs in the physical policy (default=em)
42
policy is the current default. However, when invoking biosdevname in
43
udev rules, one should always specify the policy you want, as the
44
default has changed over time.
48
policy uses the following scheme:
53
pci<slot>#<port>_<virtual instance>
54
for cards in PCI slots
59
policy makes a best guess at what the device order should be, with
60
embedded devices first, PCI cards in ascending slot order, and ports
61
in ascending PCI bus/device/function order breadth-first. However,
64
if your PCI devices are hot-plugged or hot-pluggable, including the
65
virtual functions on an SR-IOV device. In a hot-plug scenario, each separate
66
udev instance will be invoked in parallel, while the device tree is
67
still being populated with new devices. Each udev instance will see a
68
different PCI tree, and thus cannot provide consistent enumeration.
69
Use of this policy should be limited to only scenarios where all PCI
70
devices are present at boot (cold-plug).
73
Returns 0 on success, with BIOS-suggested name printed to stdout.
75
Returns 1 on provided device name lookup failure.
77
Returns 2 if system BIOS does not provide naming information.
78
biosdevname requires system BIOS to provide naming information, either
79
via SMBIOS or sysfs files.
81
Returns 3 if not run as root but requires root privileges.
83
Returns 4 if running in a virtual machine.
87
http://linux.dell.com/wiki/index.php/Oss/libnetdevname
89
http://linux.dell.com/files/biosdevname/
91
git://linux.dell.com/biosdevname.git
97
package contains two tools useful for debugging BIOS features that
98
biosdevname uses, specifically
100
to read the SMBIOS Type 9 and Type 41 tables, and
102
to read the PCI IRQ Routing Table. Please include the output of each
103
of these programs in any bug reports.
105
biosdevname was written by Matt Domsch <Matt_Domsch@dell.com>
107
This manual page was written by Rudy Gevaert <Rudy.Gevaert@UGent.be>,
108
for the Debian project (but may be used by others).