From leres@hot.ee.lbl.gov  Tue Oct 27 18:22:46 1998
Received: from hot.ee.lbl.gov (hot.ee.lbl.gov [131.243.1.42])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id SAA05644
          for <FreeBSD-gnats-submit@freebsd.org>; Tue, 27 Oct 1998 18:22:45 -0800 (PST)
          (envelope-from leres@hot.ee.lbl.gov)
Received: (from leres@localhost)
	by hot.ee.lbl.gov (8.9.1/8.9.1) id SAA24932;
	Tue, 27 Oct 1998 18:22:07 -0800 (PST)
Message-Id: <199810280222.SAA24932@hot.ee.lbl.gov>
Date: Tue, 27 Oct 1998 18:22:07 PST
From: Craig Leres <leres@ee.lbl.gov>
To: FreeBSD-gnats-submit@freebsd.org
Subject: da(4) references nonexistent da(9)

>Number:         8472
>Category:       docs
>Synopsis:       da(4) references nonexistent da(9)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    billf
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 27 18:30:00 PST 1998
>Closed-Date:    Fri Jul 2 09:29:35 PDT 1999
>Last-Modified:  Fri Jul  2 09:30:02 PDT 1999
>Originator:     Craig Leres
>Release:        FreeBSD 3.0-RELEASE i386
>Organization:
Lawrence Berkeley National Laboratory
>Environment:


>Description:

	The da(4) man page references da(9) in the "SEE ALSO" section
	but there is no da(9) man page.

	While I was poking around I also fixed some spelling typos.

>How-To-Repeat:

>Fix:

*** da.4.virgin	Tue Oct 27 18:14:11 1998
--- da.4	Tue Oct 27 18:21:01 1998
***************
*** 54,60 ****
  .Tn SCSI
  direct access device can be configured.
  .Sh PARTITIONING
! The 
  .Nm
  driver allows the disk to have two levels of partitioning.
  One layer, called the
--- 54,60 ----
  .Tn SCSI
  direct access device can be configured.
  .Sh PARTITIONING
! The
  .Nm
  driver allows the disk to have two levels of partitioning.
  One layer, called the
***************
*** 76,82 ****
  respectively.
  .Pp
  If an uninitialized disk is opened, the slice table will be
! initialized with a ficticious
  .Tn FreeBSD
  slice spanning the entire disk.  Similarly, if an uninitialized
  (or
--- 76,82 ----
  respectively.
  .Pp
  If an uninitialized disk is opened, the slice table will be
! initialized with a fictious
  .Tn FreeBSD
  slice spanning the entire disk.  Similarly, if an uninitialized
  (or
***************
*** 89,100 ****
  Many direct access devices are equiped with read and/or write caches.
  Parameters affecting the device's cache are stored in mode page 8,
  the caching control page.  Mode pages can be examined and modified
! via the 
  .Xr camcontrol 8
  utility.
  
  The read cache is used to store data from device initiated read ahead
! operations as well as frequently used data.  The read cache is transparant
  to the user and can be enabled without any adverse effect.  Most devices
  with a read cache come from the factory with it enabled.  The read cache
  can be disabled by setting the
--- 89,100 ----
  Many direct access devices are equiped with read and/or write caches.
  Parameters affecting the device's cache are stored in mode page 8,
  the caching control page.  Mode pages can be examined and modified
! via the
  .Xr camcontrol 8
  utility.
  
  The read cache is used to store data from device initiated read ahead
! operations as well as frequently used data.  The read cache is transparent
  to the user and can be enabled without any adverse effect.  Most devices
  with a read cache come from the factory with it enabled.  The read cache
  can be disabled by setting the
***************
*** 115,121 ****
  device driver ensures that the cache and media are synchronized upon
  final close of the device or an unexpected shutdown (panic) event.  This
  ensures that it is safe to disconnect power once the operating system
! has reported that it has halted.  The write cache can be enabeled by
  setting the
  .Tn WCE
  (Write Cache Enable) bit in the caching control mode page.
--- 115,121 ----
  device driver ensures that the cache and media are synchronized upon
  final close of the device or an unexpected shutdown (panic) event.  This
  ensures that it is safe to disconnect power once the operating system
! has reported that it has halted.  The write cache can be enabled by
  setting the
  .Tn WCE
  (Write Cache Enable) bit in the caching control mode page.
***************
*** 132,144 ****
  .Sh BAD BLOCK RECOVERY
  Direct Access devices have the capability of mapping out portions of
  defective media.  Media recovery parameters are located in mode page 1,
! the Read-Write Error Recovery mode page.  The most imporatant media
  remapping features are 'Auto Write Reallocation' and 'Auto Read
  Reallocation' which can be enabled via the AWRE and ARRE bits,
! respecitvely, of the Read-Write Error Recovery page.
  Many devices do not ship from the factory with these feature enabled.
! Mode pages can be examined and modified 
! via the 
  .Xr camcontrol 8
  utility.
  .Sh KERNEL CONFIGURATION
--- 132,144 ----
  .Sh BAD BLOCK RECOVERY
  Direct Access devices have the capability of mapping out portions of
  defective media.  Media recovery parameters are located in mode page 1,
! the Read-Write Error Recovery mode page.  The most important media
  remapping features are 'Auto Write Reallocation' and 'Auto Read
  Reallocation' which can be enabled via the AWRE and ARRE bits,
! respectively, of the Read-Write Error Recovery page.
  Many devices do not ship from the factory with these feature enabled.
! Mode pages can be examined and modified
! via the
  .Xr camcontrol 8
  utility.
  .Sh KERNEL CONFIGURATION
***************
*** 149,170 ****
  .Tn SCSI
  bus.
  .Sh IOCTLS
! The following 
  .Xr ioctl 2
! calls apply to 
  .Tn SCSI
  disks as well as to other disks.  They are defined in the header file
  .Aq Pa sys/disklabel.h .
  .Pp
  .Bl -tag -width DIOCSDINFO
  .It Dv DIOCSBAD
! Usually used to set up a bad-block mapping system on the disk. 
  .Tn SCSI
  drives incorporate their own bad-block mapping so this command is not
  implemented.
  .It Dv DIOCGDINFO
  Read, from the kernel, the in-core copy of the disklabel for the
! drive. This may be a ficticious disklabel if the drive has never
  been initialized, in which case it will contain information read
  from the
  .Tn SCSI
--- 149,170 ----
  .Tn SCSI
  bus.
  .Sh IOCTLS
! The following
  .Xr ioctl 2
! calls apply to
  .Tn SCSI
  disks as well as to other disks.  They are defined in the header file
  .Aq Pa sys/disklabel.h .
  .Pp
  .Bl -tag -width DIOCSDINFO
  .It Dv DIOCSBAD
! Usually used to set up a bad-block mapping system on the disk.
  .Tn SCSI
  drives incorporate their own bad-block mapping so this command is not
  implemented.
  .It Dv DIOCGDINFO
  Read, from the kernel, the in-core copy of the disklabel for the
! drive. This may be a fictious disklabel if the drive has never
  been initialized, in which case it will contain information read
  from the
  .Tn SCSI
***************
*** 273,280 ****
  .Xr wd 4 ,
  .Xr disklabel 5 ,
  .Xr disklabel 8 ,
! .Xr fdisk 8 ,
! .Xr da 9
  .Sh HISTORY
  The
  .Nm
--- 273,279 ----
  .Xr wd 4 ,
  .Xr disklabel 5 ,
  .Xr disklabel 8 ,
! .Xr fdisk 8
  .Sh HISTORY
  The
  .Nm
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: gnats-admin->freebsd-doc 
Responsible-Changed-By: steve 
Responsible-Changed-When: Sat Oct 31 12:31:13 PST 1998 
Responsible-Changed-Why:  
Misfiled PR. 
State-Changed-From-To: open->feedback 
State-Changed-By: billf 
State-Changed-When: Wed Dec 2 15:11:29 PST 1998 
State-Changed-Why:  
Those who repo. copied and made the newest changes have been contacted waiting for their opinion. 


Responsible-Changed-From-To: freebsd-doc->billf 
Responsible-Changed-By: billf 
Responsible-Changed-When: Wed Dec 2 15:11:29 PST 1998 
Responsible-Changed-Why:  
I will make the changes as soon as Ken and Gibbs respond. 
State-Changed-From-To: feedback->analyzed 
State-Changed-By: billf 
State-Changed-When: Sat Apr 24 20:37:13 PDT 1999 
State-Changed-Why:  
I need to make these spelling changes. I will remove the reference to 
the da(9) page until one is written. 

From: rme@nightfly.apk.net (R. Matthew Emerson)
To: freebsd-gnats-submit@freebsd.org, leres@ee.lbl.gov
Cc:  
Subject: Re: docs/8472: da(4) references nonexistent da(9)
Date: 05 Jun 1999 02:15:19 -0400

 Please note that "fictitious" is the correct spelling of
 the word.  The proposed correction "ficticious" is wrong.
 
 -matt
 
 (sorry if I'm not supposed to be sending mail here...)
 
State-Changed-From-To: analyzed->closed 
State-Changed-By: jkh 
State-Changed-When: Fri Jul 2 09:29:35 PDT 1999 
State-Changed-Why:  
Outdated 
>Unformatted:
