Unix/Linux Go Back    


CentOS 7.0 - man page for biosdevname (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


BIOSDEVNAME(1)									   BIOSDEVNAME(1)

NAME
       biosdevname - give BIOS-given name of a device

SYNOPSIS
       biosdevname [options] [args]...

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

OPTIONS
       -i, --interface
	      Treat [args] as ethernet devs

       -d, --debug
	      Enable debugging

       -p, --policy [physical|all_ethN]

       -P, --prefix [string]
	      string use for embedded NICs in the physical policy (default=em)

       -x, --nopirq
	      Do not use $PIR table for mapping PCI device to slot. Some BIOS have incorrect val-
	      ues.

       -s, --smbios [x.y]
	      Require minimum SMBIOS version x.y

POLICIES
       The  physical  policy  is the current default.  However, when invoking biosdevname in udev
       rules, one should always specify the policy you want, as  the  default  has  changed  over
       time.
       The physical policy uses the following scheme:

       em<port>[_<virtual instance>]
	      for embedded NICs

       p<slot>p<port>[_<virtual instance>]
	      for cards in PCI slots

       The    all_ethN	policy makes a best guess at what the device order should be, with embed-
	      ded devices first, PCI cards in ascending slot order, and ports  in  ascending  PCI
	      bus/device/function  order  breadth-first.   However,  this policy does not work if
	      your PCI devices are hot-plugged or hot-pluggable, including the virtual	functions
	      on  an  SR-IOV device.  In a hot-plug scenario, each separate udev instance will be
	      invoked in parallel, while the device  tree  is  still  being  populated	with  new
	      devices.	Each udev instance will see a different PCI tree, and thus cannot provide
	      consistent enumeration.  Use of this policy should be  limited  to  only	scenarios
	      where all PCI devices are present at boot (cold-plug).

EXIT CODES
       Returns 0 on success, with BIOS-suggested name printed to stdout.
       Returns 1 on provided device name lookup failure.
       Returns 2 if system BIOS does not provide naming information.  biosdevname requires system
       BIOS to provide naming information, either via SMBIOS or sysfs files.
       Returns 3 if not run as root but requires root privileges.
       Returns 4 if running in a virtual machine.

SEE ALSO
       http://linux.dell.com/wiki/index.php/Oss/libnetdevname
       http://linux.dell.com/files/biosdevname/
       git://linux.dell.com/biosdevname.git

RELATED PROGRAMS
       The dmidecode package contains two tools useful for debugging BIOS features that  biosdev-
       name  uses, specifically dmidecode to read the SMBIOS Type 9 and Type 41 tables, and bios-
       decode to read the PCI IRQ Routing Table.  Please include the output of each of these pro-
       grams in any bug reports.

AUTHOR
       biosdevname was written by  Matt Domsch <Matt_Domsch@dell.com>

       This  manual  page  was	written  by  Rudy Gevaert <Rudy.Gevaert@UGent.be>, for the Debian
       project (but may be used by others).

					   Nov 28, 2010 			   BIOSDEVNAME(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:02 PM.