2.1. Fibre Channel API

2.1. Fibre Channel API

Below is a list of /sys/class/ directories that contain files used to provide the userspace API. In each item, host numbers are designated by <H>, bus numbers are <B>, targets are <T>, LUNs are <L>, and remote port numbers are <R>.

Transport: /sys/class/fc_transport/target<H>:<B>:<T>/
  • port_id — 24-bit port ID/address

  • node_name — 64-bit node name

  • port_name — 64-bit port name

Remote Port: /sys/class/fc_remote_ports/rport-<H>:<B>-<R>/
  • port_id

  • node_name

  • port_name

  • dev_loss_tmo — number of seconds to wait before marking a link as "bad". Once a link is marked bad, IO running on its corresponding path (along with any new IO on that path) will be failed.

    The default dev_loss_tmo value varies, depending on which driver/device is used. If a Qlogic adapter is used, the default is 35 seconds, while if an Emulex adapter is used, it is 30 seconds. The dev_loss_tmo value can be changed via the scsi_transport_fc module parameter dev_loss_tmo, although the driver can override this timeout value.

    The maximum dev_loss_tmo value is 600 seconds. If dev_loss_tmo is set to zero or any value greater than 600, the driver's internal timeouts will be used instead.

  • fast_io_fail_tmo — length of time to wait before failing IO executed when a link problem is detected. IO that reaches the driver will fail. If IO is in a blocked queue, it will not be failed until dev_loss_tmo expires and the queue is unblocked.

Host: /sys/class/fc_host/host<H>/
  • port_id

  • issue_lip — instructs the driver to rediscover remote ports.