diff options
author | Bartlomiej Zolnierkiewicz <bzolnier@gmail.com> | 2009-01-06 11:20:51 -0500 |
---|---|---|
committer | Bartlomiej Zolnierkiewicz <bzolnier@gmail.com> | 2009-01-06 11:20:51 -0500 |
commit | ff670e632e818535950d9e31d9d0dcfc7d5b4090 (patch) | |
tree | 3ac6ade46bb9d2ae8578ed63fa8946f817749026 /drivers | |
parent | b65fac32cfe3b2f98cd472fef400bd1c1340de23 (diff) |
ide: update ide_unregister() documentation
Signed-off-by: Bartlomiej Zolnierkiewicz <bzolnier@gmail.com>
Diffstat (limited to 'drivers')
-rw-r--r-- | drivers/ide/ide.c | 18 |
1 files changed, 5 insertions, 13 deletions
diff --git a/drivers/ide/ide.c b/drivers/ide/ide.c index 9e403282dfa7..6538b63158bf 100644 --- a/drivers/ide/ide.c +++ b/drivers/ide/ide.c | |||
@@ -155,22 +155,14 @@ EXPORT_SYMBOL_GPL(ide_port_unregister_devices); | |||
155 | * ide_unregister - free an IDE interface | 155 | * ide_unregister - free an IDE interface |
156 | * @hwif: IDE interface | 156 | * @hwif: IDE interface |
157 | * | 157 | * |
158 | * Perform the final unregister of an IDE interface. At the moment | 158 | * Perform the final unregister of an IDE interface. |
159 | * we don't refcount interfaces so this will also get split up. | ||
160 | * | 159 | * |
161 | * Locking: | 160 | * Locking: |
162 | * The caller must not hold the IDE locks | 161 | * 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. | ||
171 | * | 162 | * |
172 | * Unregister restores the hwif structures to the default state. | 163 | * It is up to the caller to be sure there is no pending I/O here, |
173 | * This is raving bonkers. | 164 | * and that the interface will not be reopened (present/vanishing |
165 | * locking isn't yet done BTW). | ||
174 | */ | 166 | */ |
175 | 167 | ||
176 | void ide_unregister(ide_hwif_t *hwif) | 168 | void ide_unregister(ide_hwif_t *hwif) |