CARDMGR(8)

NAME
cardmgr - PCMCIA device manager

SYNOPSIS
cardmgr [-q] [-d] [-o] [-f] [-c configpath ] [-m modpath ] [-p pidpath ] [-s stabfile ]

DESCRIPTION
Cardmgr monitors PCMCIA sockets for card insertion and removal events. When a card is inserted, cardmgr looks up the card in a database of known cards. If the card can be identified, appropriate device drivers will be loaded and bound to the card. When a card is ejected, that card's drivers will be shut down and unloaded if possible. Based on the contents of the PCMCIA card configuration database, cardmgr may also execute arbitrary commands when appropriate cards are either inserted or removed.

All insertion and removal events, device driver loads and unloads, and startup and shutdown commands are reported in the system log file. Warnings and errors will also be logged. Current card and device information for each socket is recorded in /var/run/stab.

Normally, when a card is identified, cardmgr will send a beep to the console. A beep is also generated when a card is successfully configured. A beep of lower pitch is generated if either of these steps fails. Ejecting a card produces a single beep.

When cardmgr receives a SIGHUP signal, it will shut down all sockets, reload the config file, then re-initialize all sockets. When cardmgr receives a SIGTERM signal, it will shut down all sockets and then exit.

If the PCMCIA_OPTS environment variable is set, its contents will be parsed after the main card configuration file is read.

OPTIONS

-q  Quiet mode: don't beep when cards are inserted.

-d  Follow module dependencies when loading driver modules, by defaulting to use modprobe instead of insmod. Normally, cardmgr will try using modprobe only after an unsuccessful attempt with insmod.

-f  Foreground: do not fork and run as a daemon until after configuring any cards that are already present.

-o  One pass: configure cards that are present, then exit. This flag also forces cardmgr to run in the foreground.

-c configpath
    Look for the card configuration database and card configuration scripts in the specified directory, instead of /etc/pcmcia.

-m modpath
    Look for loadable kernel modules in the specified directory, instead of /lib/modules/`uname-r`.

-p pidpath
    Write the PID of the cardmgr process to the specified file, instead of /var/run/cardmgr.pid.

-s stabpath
    Write current socket information to the specified file, instead of /var/run/stab.

FILES
/etc/pcmcia/config
    Card configuration database
/etc/pcmcia/config.opts
    Local resource settings for PCMCIA devices
/var/run/cardmgr.pid
    PID of active cardmgr process
/var/run/stab
    Current card and device information for each socket.

AUTHOR
David Hinds - dhinds@hyper.stanford.edu

SEE ALSO
pcmcia(5), stab(5), cardctl(8), cardinfo(8).