1BIOSDEVNAME(1)              General Commands Manual             BIOSDEVNAME(1)
2
3
4

NAME

6       biosdevname - give BIOS-given name of a device
7

SYNOPSIS

9       biosdevname [options] [args]...
10

DESCRIPTION

12       biosdevname  takes a kernel device name as an argument, and returns the
13       BIOS-given name it "should" be.
14

OPTIONS

16       -i, --interface
17              Treat [args] as ethernet devs
18
19       -d, --debug
20              Enable debugging
21
22       -p, --policy [physical|all_ethN]
23
24       -P, --prefix [string]
25              string use for embedded NICs in the physical policy (default=em)
26
27       -x, --nopirq
28              Do not use $PIR table for mapping PCI device to slot. Some  BIOS
29              have incorrect values.
30
31       -s, --smbios [x.y]
32              Require minimum SMBIOS version x.y
33

POLICIES

35       The  physical  policy  is  the current default.  However, when invoking
36       biosdevname in udev rules, one should always  specify  the  policy  you
37       want, as the default has changed over time.
38       The physical policy uses the following scheme:
39
40       em<port>[_<virtual instance>]
41              for embedded NICs
42
43       p<slot>p<port>[_<virtual instance>]
44              for cards in PCI slots
45
46       The    all_ethN  policy  makes  a  best  guess at what the device order
47              should be, with embedded devices first, PCI cards  in  ascending
48              slot order, and ports in ascending PCI bus/device/function order
49              breadth-first.  However, this policy does not work if  your  PCI
50              devices  are hot-plugged or hot-pluggable, including the virtual
51              functions on an SR-IOV device.  In  a  hot-plug  scenario,  each
52              separate  udev  instance  will be invoked in parallel, while the
53              device tree is still being populated  with  new  devices.   Each
54              udev  instance  will  see  a different PCI tree, and thus cannot
55              provide consistent enumeration.  Use of this  policy  should  be
56              limited  to  only scenarios where all PCI devices are present at
57              boot (cold-plug).
58
59

EXIT CODES

61       Returns 0 on success, with BIOS-suggested name printed to stdout.
62       Returns 1 on provided device name lookup failure.
63       Returns 2 if system BIOS does not provide naming information.  biosdev‐
64       name  requires  system  BIOS  to provide naming information, either via
65       SMBIOS or sysfs files.
66       Returns 3 if not run as root but requires root privileges.
67       Returns 4 if running in a virtual machine.
68
69

SEE ALSO

71       http://linux.dell.com/wiki/index.php/Oss/libnetdevname
72       http://linux.dell.com/files/biosdevname/
73       git://linux.dell.com/biosdevname.git
74
75

77       The dmidecode package contains two tools useful for debugging BIOS fea‐
78       tures  that biosdevname uses, specifically dmidecode to read the SMBIOS
79       Type 9 and Type 41 tables, and biosdecode to read the PCI  IRQ  Routing
80       Table.   Please include the output of each of these programs in any bug
81       reports.
82

AUTHOR

84       biosdevname was written by  Matt Domsch <Matt_Domsch@dell.com>
85
86       This manual page was written by Rudy  Gevaert  <Rudy.Gevaert@UGent.be>,
87       for the Debian project (but may be used by others).
88
89
90
91                                 Nov 28, 2010                   BIOSDEVNAME(1)
Impressum