Skip to main content

Grokking Linux Modules


A lot of the functionality of Linux is contained in the kernel modules. These small pieces of software link the Linux kernel to your hardware, but it's not all that easy to get information about them if you are having trouble with a particular module.


The command lsmod will list all currently loaded modules.

The command modinfo will list general information about a particular module.

The command get_module will list specific information about a particular module as loaded in your kernel.

My system was generating an error message about the shpchp module. To see what other modules might be associated with it:

# lsmod | grep shpchp
shpchp 33556 0
pci_hotplug 29476 1 shpchp

To get the general information about the module:

# modinfo shpchp
filename: /lib/modules/2.6.27.5-desktop-2mnb/kernel/drivers/pci/hotplug/shpchp.ko.gz
license: GPL
description: Standard Hot Plug PCI Controller Driver
author: Dan Zink , Greg Kroah-Hartman , Dely Sy
alias: pci:v*d*sv*sd*bc06sc04i00*
depends: pci_hotplug
vermagic: 2.6.27.5-desktop-2mnb SMP mod_unload 686
parm: shpchp_debug:Debugging mode enabled or not (bool)
parm: shpchp_poll_mode:Using polling mechanism for hot-plug events or not (bool)
parm: shpchp_poll_time:Polling mechanism frequency, in seconds (int)

Here, the author of this module has provided a human-understandable description of the module (not all do), tells us what the license is, where the module can be found on our system internal alias of the device will be, and provides an email address or two if we need to report a bug with the module. The items marked param: are the configurable parameters of the module, but what are the values used on this system?

# get_module shpchp
initstate : live
refcnt : 0
Parameters:
shpchp_debug : Y
shpchp_poll_mode : N
shpchp_poll_time : 0
Sections:
.altinstr_replacement : 0xf8f66ab1
.altinstructions : 0xf8f68308

__bug_table : 0xf8f68397
__param : 0xf8f682cc

You can see that the descriptions under Parameters: match up with those shown by the modinfo command. So debugging is enabled; we are NOT using the poling mechanism for hot-plugging events; and we are not polling. But what does all that mean? If we believe all the Linux propaganda, we should be able to look at the source code and get a clue and get help from the maintainer. Well, no quite . . .

Lo and behold, if we search the several files that comprise the source code for the shpchp module, there is a reference to
/*
* Mask Global Interrupt Mask - see implementation
* note on p. 139 of SHPC spec rev 1.0
*/

After a little searching on Google, the Standard Hotplug Controller (SHPC) specification is hosted at PCI-SIG, the Peripheral Component Interconnect Standards Industry Group, at their website along with lots of documentation about the PCI bus. However, membership in the organization is required to download the document.

Fortunately for us, it doesn't seem relevant anyway since the error message is:

shpchp: shpc_init: cannot reserve MMIO region

and since MMIO is Memory Mapped Input Output, it seems that the driver cannot reserve the memory space it wanted. That means a bug report needs to be filed with the author (since a Google search of the error message turns up nothing useful). I'll post back here if I hear anything.

UPDATE

This message apparently is no big deal and is one of those "errors" that are really more informational warnings than "errors", but it was interesting learning about some of the workings of the OS.


Comments

Popular posts from this blog

DOS4GW.EXE Version 2.01a and Alternative DOS Extenders

DOS4GW.EXE The Tenberry DOS extender DOS4GW.EXE was used by many early DOS games. I still enjoy playing many of these games and DOS4GW.EXE is usable with DOSBox , so they can be played on Linux. However, the version of DOS4GW.EXE that was included with the game was whatever was current at the time. The most recent version that includes many bugfixes that possibly affected the games when used with DOSBox have been fixed in the latest version, 2.01a. It's not free at US$49, but you can downloaded it here . Simply substitute it for whatever version of DOS4GW.EXE your game provided and enjoy the bug-fixed goodness. Tenberry also makes a "high-performance" "pro" version of DOS4GW.EXE, but it costs $300. I think that they could sell quite a few of these to hobby users (since, you know, DOS is dead) for US$5. Open Souce to the Rescue There are better performing, free and Open Source alternatives available and worth a look. DPMI Explained Let's unders

Return to Castle Wolfenstein for Modern Linux

Return to Castle Wolfenstein is a first-person shooter originally released on November 19, 2001. The game, like many other classic games, is available at GOG.com and costs only US$5.99. iortcw for Linux Don't bother with old and crusty Linux binaries offered by idsoft; they are problematic and it's painful to use them on a modern Linux. Fortunately for us, there are more modern GPL-licensed Linux binaries available for 32- and 64-bit systems as well as high resolution textures packages. The project at GitHub provides source code that can also be compiled for MS Windows using MinGW. iortcw for Windows and Mac You can download pre-compiled binaries for 32- and 64-bit Linux, MS Windows and Mac from here . Let's put our files in /usr/local/games/rtcw . As root, extract the downloaded .ZIP file for your architecture to  /usr/local/games/rtcw . All we are missing are the game data files. I purchased them from GOG.com. The game installer downloaded from GOG.com can be

Unreal Tournament GOTY/UT99 for Modern Linux

Released on November 16, 1999, Unreal Tournament (also known as UT99) is an arena first-person shooter for Multiplayer on-line competition or you can play against bots off-line. It features several game types, with more details provided at Wikipedia . The game was re-released on February 25, 2000 as Unreal Tournament Game of the Year Edition (GOTY) which included the three bonus packs released previously and additional mods, or game modifiers that had become popular. It is the GOTY version that is available from STEAM or  GOG.com . The GOG version for Windows installs in Linux and plays well using WINE , PlayOnLinux or Codeweaver's Crossover . There is a Linux binary available in two versions, one for the original game and one for the GOTY edition . Also provided at that site is the Official Bonus Pack with a Linux installer. All these Linux installers are created with makeself . There are some issues using such a crusty old Linux binary. Let's see why getting a Lin