svn commit: r189165 - stable/7/share/man/man9

[Edward Tomasz Napierala]

Author: trasz
Date: Sat Feb 28 11:22:09 2009
New Revision: 189165
URL: http://svn.freebsd.org/changeset/base/189165

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

Modified:
  stable/7/share/man/man9/   (props changed)
  stable/7/share/man/man9/Makefile
  stable/7/share/man/man9/disk.9

Modified: stable/7/share/man/man9/Makefile
==============================================================================
--- stable/7/share/man/man9/Makefile	Sat Feb 28 11:20:37 2009	(r189164)
+++ stable/7/share/man/man9/Makefile	Sat Feb 28 11:22:09 2009	(r189165)
@@ -559,7 +559,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: stable/7/share/man/man9/disk.9
==============================================================================
--- stable/7/share/man/man9/disk.9	Sat Feb 28 11:20:37 2009	(r189164)
+++ stable/7/share/man/man9/disk.9	Sat Feb 28 11:22:09 2009	(r189165)
@@ -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