CARDMGR(8) CARDMGR(8)
NAME
cardmgr - PCMCIA device manager
SYNOPSIS
cardmgr [-V] [-q] [-o] [-f] [-v] [-c configpath] [-m modpath] [-p pid-
file(1,n)] [-s stabfile]
DESCRIPTION
Cardmgr monitors PCMCIA sockets for card insertion and removal events.
When a card is inserted, cardmgr looks up the card in(1,8) 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(3,n) 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(2,8) commands are reported in(1,8) the system log file.
Warnings and errors will also be logged. Current card and device
information for each socket(2,7,n) is recorded in(1,8) /var/lib/pcmcia/stab.
Normally, when a card is identified, cardmgr will send(2,n) a beep(1,3x,3x curs_beep) to the
console. A beep(1,3x,3x curs_beep) is also generated when a card is successfully config-
ured. A beep(1,3x,3x curs_beep) of lower pitch is generated if(3,n) either of these steps
fails. Ejecting a card produces a single beep.
When cardmgr receives a SIGHUP signal(2,7), it will reload its configuration
file. When cardmgr receives a SIGTERM signal(2,7), it will shut down all
sockets that are not busy and then exit(3,n,1 builtins), but drivers for busy sockets
will stay loaded.
If the PCMCIA_OPTS environment variable is set(7,n,1 builtins), its contents will be
parsed after the main card configuration file(1,n) is read.
At startup, cardmgr requires that /tmp reside on a filesystem that per-
mits special device files (i.e., a real linux filesystem, that is not
mounted "nodev").
OPTIONS
-V Show version(1,3,5) information and exit.
-q Quiet mode: don't beep(1,3x,3x curs_beep) when cards are inserted.
-v Verbose mode: generates more informational messages during nor-
mal operation. Configuration scripts are executed with VER-
BOSE=y.
-f Foreground: do not fork and run as a daemon until after config-
uring any cards that are already present.
-o One pass: configure cards that are present, then exit. This
flag also forces cardmgr to run in(1,8) the foreground.
-c configpath
Look for the card configuration database and card configuration
scripts in(1,8) the specified directory, instead of /etc/pcmcia.
-m modpath
Look for loadable kernel modules in(1,8) the specified directory,
instead of /lib/modules/`uname(1,2) -r`.
-p pidfile
Write the PID of the cardmgr process to the specified file(1,n),
instead of /var/run/cardmgr.pid.
-s stabfile
Write current socket(2,7,n) information to the specified file(1,n), instead
of /var/lib/pcmcia/stab.
FILES
/etc/pcmcia/config(1,5) Card configuration database
/etc/pcmcia/config.opts Local resource settings for PCMCIA devices
/var/run/cardmgr.pid PID of active cardmgr process
/var/lib/pcmcia/stab Current card and device information for each
socket.
AUTHOR
David Hinds - dahinds@users.sourceforge.net
SEE ALSO
pcmcia(5), stab(5), cardctl(8).
pcmcia-cs 2002/11/01 06:37:45 CARDMGR(8)