svn commit: r188917 - head/share/man/man9

[Edward Tomasz Napierala]

Author: trasz
Date: Sun Feb 22 13:38:16 2009
New Revision: 188917
URL: http://svn.freebsd.org/changeset/base/188917

Log:
  Mention disk_gone() in disk(9).
  
  Approved by:	rwatson (mentor)

Modified:
  head/share/man/man9/Makefile
  head/share/man/man9/disk.9

Modified: head/share/man/man9/Makefile
==============================================================================
--- head/share/man/man9/Makefile	Sun Feb 22 13:37:22 2009	(r188916)
+++ head/share/man/man9/Makefile	Sun Feb 22 13:38:16 2009	(r188917)
@@ -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 \

Modified: head/share/man/man9/disk.9
==============================================================================
--- head/share/man/man9/disk.9	Sun Feb 22 13:37:22 2009	(r188916)
+++ head/share/man/man9/disk.9	Sun Feb 22 13:38:16 2009	(r188917)
@@ -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