Mention disk_gone() in disk(9).

Approved by:	rwatson (mentor)

2 files changed, 10 insertions, 1 deletions

diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index 0b52c4c..b632778 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -575,7 +575,9 @@ MLINKS+=devstat.9 devicestat.9 \
 	devstat.9 devstat_end_transaction.9 \
 	devstat.9 devstat_remove_entry.9 \
 	devstat.9 devstat_start_transaction.9
-MLINKS+=disk.9 disk_create.9 \
+MLINKS+=disk.9 disk_alloc.9 \
+	disk.9 disk_create.9 \
+	disk.9 disk_gone.9 \
 	disk.9 disk_destroy.9
 MLINKS+=domain.9 DOMAIN_SET.9 \
 	domain.9 net_add_domain.9 \
diff --git a/share/man/man9/disk.9 b/share/man/man9/disk.9
index a25134f..4643512 100644
--- a/share/man/man9/disk.9
+++ b/share/man/man9/disk.9
@@ -40,6 +40,8 @@
 .Ft void
 .Fn disk_create "struct disk *disk" "int version"
 .Ft void
+.Fn disk_gone "struct disk *disk"
+.Ft void
 .Fn disk_destroy "struct disk *disk"
 .Sh DESCRIPTION
 The disk storage API permits kernel device drivers providing access to
@@ -65,6 +67,11 @@ function,
 fill in the fields and call
 .Fn disk_create
 when the device is ready to service requests.
+.Fn disk_gone
+orphans all of the providers associated with the drive, setting an error
+condition of ENXIO in each one.
+In addition, it prevents a re-taste on last close for writing if an error
+condition has been set in the provider.
 After calling
 .Fn disk_destroy ,
 the device driver is not allowed to access the contents of