biosdevname(1) [centos man page]
BIOSDEVNAME(1) General Commands Manual 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 values. -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 embedded 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 biosdevname uses, specifically dmidecode to read the SMBIOS Type 9 and Type 41 tables, and biosdecode to read the PCI IRQ Routing Table. Please include the output of each of these programs 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)
Check Out this Related Man Page
smbios(1M) System Administration Commands smbios(1M) NAME
smbios - display the contents of a System Management BIOS image SYNOPSIS
smbios [-BeOsx] [-i id] [-t type] [-w file] [file] DESCRIPTION
The smbios utility displays the contents of the System Management BIOS (SMBIOS) image exported by the current system or stored in a file. SMBIOS is an industry-standard mechanism for low-level system software to export hardware configuration information to higher-level system management software. The SMBIOS data format itself is defined by the Distributed Management Task Force (DMTF). Refer to http://www.dmtf.org for more information about SMBIOS and to obtain a copy of the SMBIOS specification and implementation guidelines. The SMBIOS image consists of a table of structures, each describing some aspect of the system software or hardware configuration. By default, smbios displays the entire contents of the current SMBIOS image. If the -s option is specified, smbios displays a summary of the structures that are present in the image. If the -w option is specified, smbios writes a copy of the SMBIOS image to the specified file. smbios can then be applied to the resulting file to display its content. smbios attempts to display each structure and its content in a human- readable fashion. If smbios does not recognize a structure's type or content, the raw hexadecimal data for the structure is displayed. OPTIONS
The following options are supported: -B Disable header validation for broken BIOSes. By default, smbios attempts to validate the SMBIOS header by verifying the anchor strings, header checksums, and version number. This option might be necessary when a BIOS has a non-compliant header. -e Display the contents of the SMBIOS entry point rather than the contents of the SMBIOS structure table. -i id Display only the specified structure, named by its integer id. -O Display obsolete structure types. By default, smbios elides output for structures whose type is marked as obsolete in the DMTF SMBIOS specification. -s Display only a summary listing of the structure identifiers and types, instead of the content of each selected structure. -t type Display only those structures whose type matches the specified integer type, as defined the DMTF SMBIOS specification. -w file Write a copy of the SMBIOS image to the specified file and exit. The SMBIOS entry point is written to the start of the file with its structure table address set to the file offset of the struc- ture table, and a new entry point checksum is computed. -x Display raw hexadecimal data for the selected structures in addition to human-readable output. By default, hexadecimal data is only displayed if smbios cannot display human-readable output for the selected structures. OPERANDS
The following operands are supported: file Specifies an alternate SMBIOS image to display instead of the current system's SMBIOS image. EXIT STATUS
The following exit values are returned: 0 Successful completion. All structures in the SMBIOS image were examined successfully. 1 A fatal error occurred, such as failure to open the specified file or device, or corruption in the image. 2 Invalid command-line options were specified. FILES
/dev/smbios Kernel SMBIOS image device. This device special file is used to export a snapshot of the current system SMBIOS image. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |See below. | +-----------------------------+-----------------------------+ The command-line options are Evolving. The human-readable output is Unstable. SEE ALSO
prtdiag(1M), attributes(5), smbios(7D) System Management BIOS Reference Specification (see http://www.dmtf.org) NOTES
The implementation of a System Management BIOS image is entirely at the discretion of the system and BIOS vendors. Not all systems export an SMBIOS. The SMBIOS structure content varies widely between systems and BIOS vendors and frequently does not comply with the guidelines included in the specification. Some structure fields might not be filled in by the BIOS at all, and others might be filled inwith non-con- forming values. SunOS 5.11 31 Aug 2005 smbios(1M)