This directory (normally /var/lib/target/fabric) contains the spec files for
RisingTide Systems's LIO SCSI target subsystem fabric modules.

Each spec file should be named MODULE.spec, where MODULE is the name the fabric
module is to be referred as.

The spec file is in Python. It defines parameters for rtslib to access the
fabric if they differ from the defaults.

Available parameters
--------------------

* features
Lists the target fabric available features. Default value:
("discovery_auth", "acls", "acls_auth", "nps")
example: features = ("discovery_auth", "acls", "acls_auth")
example: features = () # no features supported

Detail of features:

  * tpgts
  The target fabric module is using iSCSI-style target portal group tags.

  * discovery_auth
  The target fabric module supports a fabric-wide authentication for
  discovery.
  
  * acls
  The target's TPGTs support explicit initiator ACLs.
  
  * acls_auth
  The target's TPGT's ACLs support per-ACL initiator authentication.
  
  * nps
  The TPGTs support iSCSI-like IPv4/IPv6 network portals, using IP:PORT
  group names.
  
  * nexus
  The TPGTs have a 'nexus' attribute that contains the local initiator
  serial unit. This attribute must be set before being able to create any
  LUNs.
  
* wwn_type
Sets the type of WWN expected by the target fabric. Defaults to 'free'.
Example: wwn_type = "iqn"
Current valid types are:

  * free
  Freeform WWN.

  * iqn
  The fabric module targets are using iSCSI-type IQNs.

  * naa
  NAA SAS address type WWN.

  * unit_serial
  Disk-type unit serial.

* wwns()
This generator function returns valid target WWNs for the fabric, if WWNs
should be chosen from existing fabric interfaces. The most common case for
this is hardware-set WWNs. This function should return a string with the
WWN formatted for what the fabric module expects.

See existing spec files for examples of generator functions.

* kernel_module
Sets the name of the kernel module implementing the fabric modules. If not
specified, it will be assumed to be MODULE_target_mod, where MODNAME is the
name of the fabric module, as used to name the spec file. Note that you must
not specify any .ko or such extension here.
Example: kernel_module = "my_module"

* configfs_group
Sets the name of the configfs group used by the fabric module. Defaults to the
name of the module as used to name the spec file.
Example: configfs_group = "iscsi"
