Re: [patch 0/5] Add MMC password protection (lock/unlock) support



[resending summary because our first attempt failed]

Hi,

These series of patches add support for MultiMediaCard (MMC) password
protection, as described in the MMC Specification v4.1. This feature is
supported by all compliant MMC cards, and used by some devices such as Symbian
OS cell phones to optionally protect MMC cards with a password. Password length
is limited to 16 bytes.

By default, a MMC card with no password assigned is always in "unlocked" state.
After password assignement, in the next power cycle the card switches to a
"locked" state where only the "basic" and "lock card" command classes are
accepted by the card. Only after unlocking it with the correct password the
card can be normally used for operations like block I/O.

Password management and caching is done through the "Kernel Key Retention
Service" mechanism and the sysfs filesystem. The Key Retention Service is used
for (1) unlocking the card, (2) assigning a password to an unlocked card and
(3) change a card's password. To remove the password and check locked/unlocked
status, a new sysfs attribute was added to the MMC driver.

Along with this thread will be sent a script that tests all possible user
scenarios described above. Also will be attached a tarball containing a simple
text-only reference UI to demonstrate how to manipulate the password.

TODO:

- MMC hotplugging needs to be extended to properly call probe() for the
different MMC drivers (currently only mmc_block). Currently, the block driver
is not notified in any way that the card was unlocked.

- Password caching: when inserting a locked card, the driver should try to
unlock it with the currently stored password (if any), and if it fails,
revoke the key containing it and fallback to the normal "no password present"
situation.

- Currently, some host drivers assume the block length will always be a power
of 2. This is not true for the MMC_LOCK_UNLOCK command, which is a block
command that accepts arbitratry block lengths. We have made the necessary
changes to the omap.c driver (present on the linux-omap tree), but the same
needs to be done for other hosts' drivers.

Known Issue:

- Some cards have an incorrect behaviour (hardware bug?) regarding password
acceptance: if an affected card has password <pwd>, it accepts <pwd><xxx> as
the correct password too, where <xxx> is any sequence of characters, of any
length. In other words, on these cards only the first <password length> bytes
need to match the correct password.

Comments or suggestions are welcome.

--
Anderson Briglia,
Anderson Lizardo,
Carlos Eduardo Aguiar

Embedded Linux Lab - 10LE
Nokia Institute of Technology - INdT
Manaus - Brazil

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/



Relevant Pages

  • Re: [RFC] MTD driver for MMC cards
    ... You can get similar functionality by using the mmc_block driver together ... The MTD file systems also expect the ... in using extra kernel threads to operate on the card in the background. ... I can comment it from a MMC perspective, but the MTD stuff I will have to assume is correct. ...
    (Linux-Kernel)
  • Re: [PATCH 1/1] mmc: add MODALIAS linkage for MMC/SD devices
    ... It makes much more sense for the mmc bus driver and the mmc-block module to ... always loading mmc_block on card insertion. ...
    (Linux-Kernel)
  • Re: [PATCH] MMC/SD host driver for Ricoh Bay1Controllers
    ... However it will never get activated without a driver for the yenta bridge. ... complex to figure out which command is being issued (it would have to ... emulate the card state machine for every possible card type). ... I guess it doesn't properly support MMC in that case. ...
    (Linux-Kernel)
  • [RFC] 1/4 MMC layer
    ... This patch adds core support to the Linux kernel for driving MMC ... * Ensure that no card is selected. ... +static struct mmc_card * ... +static int mmc_major; ...
    (Linux-Kernel)
  • [patch 0/5] [RFC] Add MMC password protection (lock/unlock) support
    ... These series of patches add support for MultiMediaCard (MMC) password ... a MMC card with no password assigned is always in "unlocked" state. ... Only after unlocking it with the correct password the ... a new sysfs attribute was added to the MMC driver. ...
    (Linux-Kernel)