5025 import and use mandoc
Reviewed by: Hans Rosenfeld <hans.rosenfeld@nexenta.com>
Reviewed by: Igor Kozhukhov <ikozhukhov@gmail.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Albert Lee <trisk@nexenta.com>
Approved by: TBD

          --- old/usr/src/man/man7d/cpqary3.7d
          +++ new/usr/src/man/man7d/cpqary3.7d

   1    1  .\"
   2    2  .\" This file and its contents are supplied under the terms of the
   3    3  .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4    4  .\" You may only use this file in accordance with the terms of version
   5    5  .\" 1.0 of the CDDL.

   6    6  .\"
   7    7  .\" A full copy of the text of the CDDL should have accompanied this
   8    8  .\" source.  A copy of the CDDL is also available via the Internet at
   9    9  .\" http://www.illumos.org/license/CDDL.
  10   10  .\"
  11   11  .\"
  12   12  .\" Copyright (C) 2013 Hewlett-Packard Development Company, L.P.
  13   13  .\"
  14   14  .TH CPQARY3 7D Aug 26, 2013"
  15   15  .SH NAME
  16      -.LP
  17   16  cpqary3 - provides disk and SCSI tape support for HP Smart Array controllers
  18      -.LP
  19   17  .SH DESCRIPTION
  20   18  .LP
  21   19  The cpqary3 module provides low-level interface routines between the common
  22   20  disk I/O subsystem and the HP SMART Array controllers. The cpqary3 driver
  23   21  provides disk and SCSI tape support for the HP Smart Array controllers.
  24   22  .LP
  25   23  Please refer to the cpqary3 release notes, for the supported HP Smart Array
  26   24  Controllers and Storage boxes.
  27   25  .LP
  28   26  Each controller should be the sole initiator on a SCSI bus. Auto

  29   27  configuration code determines if the adapter is present at the Configured
  30   28  address and what types of devices are attached to it.
  31   29  .SH CONFIGURATION
  32   30  Use the Array Configuration Utility to configure the controllers. Each
  33   31  controller can support up to 32 logical volumes. In addition, each controller
  34   32  supports up to a maximum of 28 connected SCSI tape drives.
  35   33  With 1.90 and later versions of cpqary3 driver, HP Smart Array SAS controllers,
  36   34  having Firmware Revision 5.10 or later, will support 64 logical drives. This
  37   35  firmware also supports Dual Domian Multipath configurations.
  38   36  .LP
  39   37  The driver attempts to initialize itself in accordance with the information
  40   38  found in the configuration file, /kernel/drv/cpqary3.conf.
  41   39  .LP
  42   40  New component - hmaeventd which logs the storage events onto console and to the
  43   41  Integrated Management Log is made a part of HPQhma 5.0.0 package, which is not
  44   42  part of the operating system.  Therefore, by default, notify on event
  45   43  functionality is disabled in the driver from 2.1.0 onwards.  Storage event
  46   44  logging may be enabled in the driver by modifying cpqary3.conf to set the
  47   45  cpqary3_noe property to "on".  Modification of driver properties requires
  48   46  reloading the driver, which in most cases will occur only following a reboot of
  49   47  the system.
  50   48  .LP
  51   49  The target driver's configuration file shall need entries if support is needed
  52   50  for targets numbering greater than the default number of targets supported by
  53   51  the corresponding target driver.
  54   52  .LP
  55   53  By default, entries for SCSI target numbers 0 to 15 are present in sd.conf.
  56   54  Entries for target numbers 16 and above must be added to the \&'scsi' class in
  57   55  sd.conf to support additional corresponding logical volumes.
  58   56  .LP
  59   57  If SCSI tape drives are connected to the supported controllers, entries for
  60   58  target IDs from 33 to 33+N must be added in the /kernel/drv/st.conf file under
  61   59  \&'scsi' class, where N is the total number of SCSI tape drives connected to the
  62   60  controller with largest number of tape drives connected to it, in the existing
  63   61  configuration. For example, two supported controller, c1 and c2 are present in
  64   62  the system. If controller c1 has two (2) tape drives and controller c2 has five
  65   63  (5) tape drives connected, then entries for target IDs 33 thru 38 are required
  66   64  under 'scsi' class in /kernel/drv/st.conf file. The maximum number of tape
  67   65  drives that can be connected to a controller is 28. With 1.90 and later versions
  68   66  of cpqary3 driver, if tape drives are connected to Smart Array SAS controllers,
  69   67  then target ID entries for tape drives from 65 to 65+N must be added in
  70   68  /kernel/drv/st.conf file under the \&'scsi' class.

  71   69  .SH FILES
  72   70  .PD 0
  73   71  .TP 25
  74   72  .B /kernel/drv/cpqary3.conf
  75   73  - configuration file for CPQary3
  76   74  .PD
  77   75  .SH "SEE ALSO"
  78   76  .BR driver.conf (4),
  79   77  .BR sd (7D),
  80   78  .BR st (7D)
  81      -.LP
  82   79  .SH NOTES
  83   80  .LP
  84   81  The Smart Array controllers supported by the current version of the
  85   82  cpqary3 driver do not support 'format unit' SCSI command. Hence, selecting
  86   83  \&'format' option under 'format' utility main menu is not supported. In addition,
  87   84  the 'repair' option under 'format' utility main menu is not supported as this
  88   85  operation is not applicable to Logical volumes connected to the supported Smart
  89   86  Array controllers.
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX