diff options
Diffstat (limited to 'docs/vyos.vyos.vyos_lldp_interfaces_module.rst')
| -rw-r--r-- | docs/vyos.vyos.vyos_lldp_interfaces_module.rst | 498 | 
1 files changed, 249 insertions, 249 deletions
| diff --git a/docs/vyos.vyos.vyos_lldp_interfaces_module.rst b/docs/vyos.vyos.vyos_lldp_interfaces_module.rst index d64b20c7..c5ea47bc 100644 --- a/docs/vyos.vyos.vyos_lldp_interfaces_module.rst +++ b/docs/vyos.vyos.vyos_lldp_interfaces_module.rst @@ -31,324 +31,330 @@ Parameters          <tr>              <th colspan="5">Parameter</th>              <th>Choices/<font color="blue">Defaults</font></th> -                        <th width="100%">Comments</th> +            <th width="100%">Comments</th>          </tr> -                    <tr> -                                                                <td colspan="5"> +            <tr> +                <td colspan="5">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>config</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">list</span> -                         / <span style="color: purple">elements=dictionary</span>                                            </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>A list of lldp interfaces configurations.</div> -                                                        </td> +                         / <span style="color: purple">elements=dictionary</span> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>A list of lldp interfaces configurations.</div> +                </td>              </tr> -                                                            <tr> -                                                    <td class="elbow-placeholder"></td> -                                                <td colspan="4"> +                                <tr> +                    <td class="elbow-placeholder"></td> +                <td colspan="4">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>enable</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">boolean</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                                                                                    <ul style="margin: 0; padding: 0"><b>Choices:</b> -                                                                                                                                                                <li>no</li> -                                                                                                                                                                                                <li><div style="color: blue"><b>yes</b> ←</div></li> -                                                                                    </ul> -                                                                            </td> -                                                                <td> -                                            <div>to disable lldp on the interface.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                        <ul style="margin: 0; padding: 0"><b>Choices:</b> +                                    <li>no</li> +                                    <li><div style="color: blue"><b>yes</b> ←</div></li> +                        </ul> +                </td> +                <td> +                        <div>to disable lldp on the interface.</div> +                </td>              </tr> -                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                                <td colspan="4"> +            <tr> +                    <td class="elbow-placeholder"></td> +                <td colspan="4">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>location</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">dictionary</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>LLDP-MED location data.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>LLDP-MED location data.</div> +                </td>              </tr> -                                                            <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="3"> +                                <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="3">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>civic_based</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">dictionary</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Civic-based location data.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Civic-based location data.</div> +                </td>              </tr> -                                                            <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="2"> +                                <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="2">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>ca_info</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">list</span> -                         / <span style="color: purple">elements=dictionary</span>                                            </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>LLDP-MED address info</div> -                                                        </td> +                         / <span style="color: purple">elements=dictionary</span> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>LLDP-MED address info</div> +                </td>              </tr> -                                                            <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="1"> +                                <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="1">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>ca_type</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">integer</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>LLDP-MED Civic Address type.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>LLDP-MED Civic Address type.</div> +                </td>              </tr> -                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="1"> +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="1">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>ca_value</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>LLDP-MED Civic Address value.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>LLDP-MED Civic Address value.</div> +                </td>              </tr> -                     -                                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="2"> + +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="2">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>country_code</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                 / <span style="color: red">required</span>                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Country Code</div> -                                                        </td> +                         / <span style="color: red">required</span> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Country Code</div> +                </td>              </tr> -                     -                                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="3"> + +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="3">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>coordinate_based</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">dictionary</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Coordinate-based location.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Coordinate-based location.</div> +                </td>              </tr> -                                                            <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="2"> +                                <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="2">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>altitude</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">integer</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Altitude in meters.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Altitude in meters.</div> +                </td>              </tr> -                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="2"> +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="2">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>datum</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                            <ul style="margin: 0; padding: 0"><b>Choices:</b> -                                                                                                                                                                <li>WGS84</li> -                                                                                                                                                                                                <li>NAD83</li> -                                                                                                                                                                                                <li>MLLW</li> -                                                                                    </ul> -                                                                            </td> -                                                                <td> -                                            <div>Coordinate datum type.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                        <ul style="margin: 0; padding: 0"><b>Choices:</b> +                                    <li>WGS84</li> +                                    <li>NAD83</li> +                                    <li>MLLW</li> +                        </ul> +                </td> +                <td> +                        <div>Coordinate datum type.</div> +                </td>              </tr> -                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="2"> +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="2">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>latitude</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                 / <span style="color: red">required</span>                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Latitude.</div> -                                                        </td> +                         / <span style="color: red">required</span> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Latitude.</div> +                </td>              </tr> -                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="2"> +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="2">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>longitude</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                 / <span style="color: red">required</span>                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Longitude.</div> -                                                        </td> +                         / <span style="color: red">required</span> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Longitude.</div> +                </td>              </tr> -                     -                                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                    <td class="elbow-placeholder"></td> -                                                <td colspan="3"> + +            <tr> +                    <td class="elbow-placeholder"></td> +                    <td class="elbow-placeholder"></td> +                <td colspan="3">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>elin</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Emergency Call Service ELIN number (between 10-25 numbers).</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Emergency Call Service ELIN number (between 10-25 numbers).</div> +                </td>              </tr> -                     -                                                <tr> -                                                    <td class="elbow-placeholder"></td> -                                                <td colspan="4"> + +            <tr> +                    <td class="elbow-placeholder"></td> +                <td colspan="4">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>name</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                 / <span style="color: red">required</span>                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>Name of the  lldp interface.</div> -                                                        </td> +                         / <span style="color: red">required</span> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>Name of the  lldp interface.</div> +                </td>              </tr> -                     -                                                <tr> -                                                                <td colspan="5"> + +            <tr> +                <td colspan="5">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>running_config</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                                                            </td> -                                                                <td> -                                            <div>This option is used only with state <em>parsed</em>.</div> -                                            <div>The value of this option should be the output received from the VyOS device by executing the command <b>show configuration commands | grep lldp</b>.</div> -                                            <div>The state <em>parsed</em> reads the configuration from <code>running_config</code> option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the <em>parsed</em> key within the result.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                </td> +                <td> +                        <div>This option is used only with state <em>parsed</em>.</div> +                        <div>The value of this option should be the output received from the VyOS device by executing the command <b>show configuration commands | grep lldp</b>.</div> +                        <div>The state <em>parsed</em> reads the configuration from <code>running_config</code> option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the <em>parsed</em> key within the result.</div> +                </td>              </tr> -                                <tr> -                                                                <td colspan="5"> +            <tr> +                <td colspan="5">                      <div class="ansibleOptionAnchor" id="parameter-"></div>                      <b>state</b>                      <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>                      <div style="font-size: small">                          <span style="color: purple">string</span> -                                                                    </div> -                                    </td> -                                <td> -                                                                                                                            <ul style="margin: 0; padding: 0"><b>Choices:</b> -                                                                                                                                                                <li><div style="color: blue"><b>merged</b> ←</div></li> -                                                                                                                                                                                                <li>replaced</li> -                                                                                                                                                                                                <li>overridden</li> -                                                                                                                                                                                                <li>deleted</li> -                                                                                                                                                                                                <li>rendered</li> -                                                                                                                                                                                                <li>parsed</li> -                                                                                                                                                                                                <li>gathered</li> -                                                                                    </ul> -                                                                            </td> -                                                                <td> -                                            <div>The state of the configuration after module completion.</div> -                                                        </td> +                    </div> +                </td> +                <td> +                        <ul style="margin: 0; padding: 0"><b>Choices:</b> +                                    <li><div style="color: blue"><b>merged</b> ←</div></li> +                                    <li>replaced</li> +                                    <li>overridden</li> +                                    <li>deleted</li> +                                    <li>rendered</li> +                                    <li>parsed</li> +                                    <li>gathered</li> +                        </ul> +                </td> +                <td> +                        <div>The state of the configuration after module completion.</div> +                </td>              </tr> -                        </table> +    </table>      <br/> @@ -366,7 +372,6 @@ Examples  .. code-block:: yaml+jinja -          # Using merged      #      # Before state: @@ -844,9 +849,6 @@ Examples - - -  Return Values  -------------  Common return values are documented `here <https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values>`_, the following are the fields unique to this module: @@ -859,60 +861,60 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late              <th>Returned</th>              <th width="100%">Description</th>          </tr> -                    <tr> -                                <td colspan="1"> +            <tr> +                <td colspan="1">                      <div class="ansibleOptionAnchor" id="return-"></div>                      <b>after</b>                      <a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>                      <div style="font-size: small">                        <span style="color: purple">list</span> -                                          </div> -                                    </td> +                    </div> +                </td>                  <td>when changed</td>                  <td> -                                                                        <div>The configuration as structured data after module completion.</div> -                                                                <br/> -                                            <div style="font-size: smaller"><b>Sample:</b></div> -                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format +                            <div>The configuration as structured data after module completion.</div> +                    <br/> +                        <div style="font-size: smaller"><b>Sample:</b></div> +                        <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format       of the parameters above.</div> -                                    </td> +                </td>              </tr> -                                <tr> -                                <td colspan="1"> +            <tr> +                <td colspan="1">                      <div class="ansibleOptionAnchor" id="return-"></div>                      <b>before</b>                      <a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>                      <div style="font-size: small">                        <span style="color: purple">list</span> -                                          </div> -                                    </td> +                    </div> +                </td>                  <td>always</td>                  <td> -                                                                        <div>The configuration as structured data prior to module invocation.</div> -                                                                <br/> -                                            <div style="font-size: smaller"><b>Sample:</b></div> -                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format +                            <div>The configuration as structured data prior to module invocation.</div> +                    <br/> +                        <div style="font-size: smaller"><b>Sample:</b></div> +                        <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format       of the parameters above.</div> -                                    </td> +                </td>              </tr> -                                <tr> -                                <td colspan="1"> +            <tr> +                <td colspan="1">                      <div class="ansibleOptionAnchor" id="return-"></div>                      <b>commands</b>                      <a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>                      <div style="font-size: small">                        <span style="color: purple">list</span> -                                          </div> -                                    </td> +                    </div> +                </td>                  <td>always</td>                  <td> -                                                                        <div>The set of commands pushed to the remote device.</div> -                                                                <br/> -                                            <div style="font-size: smaller"><b>Sample:</b></div> -                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">["set service lldp interface eth2 'disable'", 'delete service lldp interface eth1 location']</div> -                                    </td> +                            <div>The set of commands pushed to the remote device.</div> +                    <br/> +                        <div style="font-size: smaller"><b>Sample:</b></div> +                        <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">["set service lldp interface eth2 'disable'", 'delete service lldp interface eth1 location']</div> +                </td>              </tr> -                        </table> +    </table>      <br/><br/> @@ -924,5 +926,3 @@ Authors  ~~~~~~~  - Rohit Thakur (@rohitthakur2590) - - | 
