Commit ff670e632e818535950d9e31d9d0dcfc7d5b4090
1 parent
b65fac32cf
Exists in
master
and in
7 other branches
ide: update ide_unregister() documentation
Signed-off-by: Bartlomiej Zolnierkiewicz <bzolnier@gmail.com>
Showing 1 changed file with 5 additions and 13 deletions Side-by-side Diff
drivers/ide/ide.c
| ... | ... | @@ -155,22 +155,14 @@ |
| 155 | 155 | * ide_unregister - free an IDE interface |
| 156 | 156 | * @hwif: IDE interface |
| 157 | 157 | * |
| 158 | - * Perform the final unregister of an IDE interface. At the moment | |
| 159 | - * we don't refcount interfaces so this will also get split up. | |
| 158 | + * Perform the final unregister of an IDE interface. | |
| 160 | 159 | * |
| 161 | 160 | * Locking: |
| 162 | - * The caller must not hold the IDE locks | |
| 163 | - * The drive present/vanishing is not yet properly locked | |
| 164 | - * Take care with the callbacks. These have been split to avoid | |
| 165 | - * deadlocking the IDE layer. The shutdown callback is called | |
| 166 | - * before we take the lock and free resources. It is up to the | |
| 167 | - * caller to be sure there is no pending I/O here, and that | |
| 168 | - * the interface will not be reopened (present/vanishing locking | |
| 169 | - * isn't yet done BTW). After we commit to the final kill we | |
| 170 | - * call the cleanup callback with the ide locks held. | |
| 161 | + * The caller must not hold the IDE locks. | |
| 171 | 162 | * |
| 172 | - * Unregister restores the hwif structures to the default state. | |
| 173 | - * This is raving bonkers. | |
| 163 | + * It is up to the caller to be sure there is no pending I/O here, | |
| 164 | + * and that the interface will not be reopened (present/vanishing | |
| 165 | + * locking isn't yet done BTW). | |
| 174 | 166 | */ |
| 175 | 167 | |
| 176 | 168 | void ide_unregister(ide_hwif_t *hwif) |