On 11/20/14 16:08, John Ferlan wrote:
On 11/12/2014 08:47 AM, Peter Krempa wrote:
The docs describing the <host> element that are under the <source> element in the XML document were incorrectly placed under the <disk> element. Move them to the correct place. --- docs/formatdomain.html.in | 104 ++++++++++++++++++++++++---------------------- 1 file changed, 54 insertions(+), 50 deletions(-)
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index d4189e6..4f44bc0 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -1953,6 +1953,60 @@ may have zero or more <code>host</code> sub-elements used to specify the hosts to connect. </p> + + <dl> + <dt><code>host</code></dt> + <dd>The <code>host</code> element supports 4 attributes, viz. "name", + "port", "transport" and "socket", which specify the hostname, + the port number, transport type and path to socket, respectively. + The meaning of this element and the number of the elements depend + on the protocol attribute.
<p></p>
+ <table class="top_table"> + <tr> + <th> Protocol </th> + <th> Meaning </th> + <th> Number of hosts </th> + <th> Default port </th> + </tr> + <tr> + <td> nbd </td> + <td> a server running nbd-server </td> + <td> only one </td> + <td> 10809 </td> + </tr> + <tr> + <td> iscsi </td> + <td> an iSCSI server </td> + <td> only one </td> + <td> 3260 </td> + </tr> + <tr> + <td> rbd </td> + <td> monitor servers of RBD </td> + <td> one or more </td> + <td> 6789 </td> + </tr> + <tr> + <td> sheepdog </td> + <td> one of the sheepdog servers (default is localhost:7000) </td> + <td> zero or one </td> + <td> 7000 </td> + </tr> + <tr> + <td> gluster </td> + <td> a server running glusterd daemon </td> + <td> only one </td> + <td> 24007 </td> + </tr> + </table>
<p></p>
ACK - adding the <p></p> is mostly a visual thing - it separates the table from the text a bit... not sure if there's another way to do it as my html skills are spartan.
I'm going to add <p>aragraphs around the text blocks. That will automagically add a break before the table and will avoid having empty paragraph block.
John
+ gluster supports "tcp", "rdma", "unix" as valid values for the + transport attribute. nbd supports "tcp" and "unix". Others only + support "tcp". If nothing is specified, "tcp" is assumed. If the + transport is "unix", the socket attribute specifies the path to an + AF_UNIX socket. + </dd> + </dl> + <p> For a "file" or "volume" disk type which represents a cdrom or floppy (the <code>device</code> attribute), it is possible to define