MFC r344660: Add to isp(4) tunables to limit MSI/MSI-X usage.

There are some problem reports possibly related to the new driver use of
multiple interrupts on older cards. Hopefully this allow to workaround
them.

MFC r330121:
Add support for Enhanced Gen 5 (16Gb) and Gen 6 (32Gb) QLogic FC HBAs.

Sponsored by: iXsystems, Inc.

MFC r320604, r320865:
Switch fabric scans from GID_FT to GID_PT+GFF_ID/GFT_ID.

Instead of using GID_FT SNS request to get list of registered FCP ports,
use GID_PT to get list of all Nx_Ports, and then use GFF_ID and/or GFT_ID
requests to find whether they are FCP and target capable.

The problem with old approach is that GID_FT does not report ports without
FC-4 type registered. In particular it was impossible to boot OS from
FreeBSD FC target using QLogic FC BIOS, since one does not register FC-4
type even on new cards and so ignored by old code as incompatible.

As a side bonus this allows initiator to skip pointless logins to other
initiators by fetching that information from SNS instead.

In case some switches do not implement GFF_ID/GFT_ID correctly, add sysctls
to disable that functionality. I handled broken GFF_ID of my Brocade 200E,
but there may be other switches with different bugs.

Linux also uses GID_PT, but GFF_ID is disabled by default there, and GFT_ID
is not supported.

Sponsored by: iXsystems, Inc.

MFC, r310338:
------------------------------------------------------------------------
r310338 | ken | 2016-12-20 14:17:07 -0700 (Tue, 20 Dec 2016) | 37 lines

Turn on FC-Tape by default in the isp(4) driver.

FC-Tape provides additional link level error recovery, and is
highly recommended for tape devices. It will only be turned on for
a given target if the target supports it.

Without this setting, we default to whatever FC-Tape setting is in
NVRAM on the card.

This can be overridden by setting the following loader tunable, for
example for isp0:

hint.isp.0.nofctape=1

sys/conf/options:
Add a new kernel config option, ISP_FCTAPE_OFF, that
defaults the FC-Tape configuration to off.

sys/dev/isp/isp_pci.c:
If ISP_FCTAPE_OFF is defined, turn off FC-Tape. Otherwise,
turn it on if the card supports it.

share/man/man4/isp.4:
Add a description of FC-Tape to the isp(4) man page.

Add descriptions of the fctape and nofctape options, as well as the
ISP_FCTAPE_OFF kernel configuration option.

Add the ispfw module and kernel drivers to the suggested
configurations at the top of the man page so that users are less
likely to leave it out. The driver works well with the included
firmware, but may not work at all with whatever firmware the user
has flashed on their card.

Sponsored by: Spectra Logic

------------------------------------------------------------------------
Sponsored by: Spectra Logic

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Update list of card names.

Remove "disable" hint, which duplicates system-wide "disabled".

Fix target mode support for Qlogic 2200 FC adapters.

Now target mode works for all supported FC adapters except ancient 2100,
which is not tested.

Rip off target mode support for parallel SCSI QLogic adapters.

Hacks to enable target mode there complicated code, while didn't really
work. And for outdated hardware fixing it is not really interesting.

Initiator mode tested with Qlogic 1080 adapter is still working fine.

Some minor additions to r290138,

Some updates to isp(4) manual page.

Fix various mdoc issues.

Found with: mandoc -Tlint

Document ISP 2532 support and hint.isp.0.vports tunable.

MFC after: 1 week

General mdoc(7) and typo fixes.

PR: 167776
Submitted by: Nobuyuki Koganemaru (kogane!jp.freebsd.org)
MFC after: 3 days

Remove superfluous paragraph macro.

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

Fix a couple of typos.

PR: docs/148891
Submitted by: olgeni
MFC after: 1 week

Make gmultipath(8) easier to find.

New sentence -> new line and contractions removed.

Update the isp man page.
MFC after: 2 weeks

Markup fixes.

Convert to use a SYNPOSIS section that mentions kernel modules.
Also add "device scbus" where needed.

MFC after: 3 days

Fix typo in device hint variable

Update man page for some booting and settings stuff.

Remove a bunch of cards from vendors who are long since defunct.
Add a note about 2322 support.

Obtained from: Marcus

Expand *n't contractions.

Fixed the misplaced $FreeBSD$.

Sort sections.

- Make the HARDWARE section preamble text have a call to the Nm macro,
so the driver name will appear in the Hardware Notes.

Catch up isp.4 manpage with hardware notes.

PR: 55558
Submitted by: Lukas Ertl <l.ertl@univie.ac.at>

Note the Qlogic 1040 is a KZPBA in DEC-speak.

Reviewed by: wilko

Ispell sweep of share/man/man4.

mdoc(7) police: removed hard sentence breaks.

add 2300/2312 references

xref to ispfw(4) in see also

Approved by: mjacob
MFC after: 2 days

Strongly recommend that ispfw(4)'s f/w be used with this driver if available.

MFC after: 1 week

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

mdoc(7) police: use certified section headers wherever possible.

Avoid use of direct troff requests in mdoc(7) manual pages.

Update isp man page, add ispfw man page.

Fix some spelling errors.

Remove more single-space hard sentence breaks.

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

Add (finally) Qlogic man page.

approved: jkh