From df711eaea09bd6f6d9e42b1150a221ca4f49efef Mon Sep 17 00:00:00 2001
From: Lucas Alvares Gomes <lucasagomes@gmail.com>
Date: Wed, 7 Dec 2016 12:03:56 +0000
Subject: [PATCH] Document HCTL for root device hints

This patch is documenting the new root device hint: HCTL and adding a
release note for it.

Closes-Bug: #1648036
Change-Id: Ie7ef0e25aed50ea5372d7cfe80778575f8560271
---
 install-guide/source/include/root-device-hints.rst            | 2 ++
 .../notes/hctl-root-device-hints-0cab86673bc4a924.yaml        | 4 ++++
 2 files changed, 6 insertions(+)
 create mode 100644 releasenotes/notes/hctl-root-device-hints-0cab86673bc4a924.yaml

diff --git a/install-guide/source/include/root-device-hints.rst b/install-guide/source/include/root-device-hints.rst
index 672bdfb830..be36290df9 100644
--- a/install-guide/source/include/root-device-hints.rst
+++ b/install-guide/source/include/root-device-hints.rst
@@ -25,6 +25,8 @@ deployment. The list of support hints is:
 * rotational (BOOLEAN): whether it's a rotational device or not. This
   hint makes it easier to distinguish HDDs (rotational) and SSDs (not
   rotational) when choosing which disk Ironic should deploy the image onto.
+* hctl (STRING): the SCSI address (Host, Channel, Target and Lun),
+  e.g '1:0:0:0'
 * name (STRING): the device name, e.g /dev/md0
 
 
diff --git a/releasenotes/notes/hctl-root-device-hints-0cab86673bc4a924.yaml b/releasenotes/notes/hctl-root-device-hints-0cab86673bc4a924.yaml
new file mode 100644
index 0000000000..b6cad0202d
--- /dev/null
+++ b/releasenotes/notes/hctl-root-device-hints-0cab86673bc4a924.yaml
@@ -0,0 +1,4 @@
+---
+features:
+  - Add ``hctl`` to root device hints. HCTL is the SCSI address and
+    stands for Host, Channel, Target and Lun.