This is merely a historical archive of years 2008-2021, before the migration to mailman3.
A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.
dexter gerrit-no-reply at lists.osmocom.orgdexter has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/20522 )
Change subject: vty: explain how command attributes are used
......................................................................
vty: explain how command attributes are used
The VTY features a method to associate commands with certain
attrubutes. Tell the VTY user how to use the help to display the
attributes and their meaning.
Change-Id: If03e07f1f8e7e3c0166a00e3f395e2a46a9a7713
Related: SYS#4937, OS#1601
---
M common/chapters/vty.adoc
1 file changed, 88 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/22/20522/1
diff --git a/common/chapters/vty.adoc b/common/chapters/vty.adoc
index 3aed41a..dec3be2 100644
--- a/common/chapters/vty.adoc
+++ b/common/chapters/vty.adoc
@@ -344,3 +344,91 @@
periodic location update <6-1530>
no periodic location update
----
+
+==== The attribute system
+
+The VTY allows to edit the configuration at runtime. For many VTY commands the
+configuration change is immediately valid but for some commands a change becomes
+valid on a certain event only. In some cases it is even necessary to restart the
+whole process.
+
+To give the user an overview, which configuration change applies when, the VTY
+implemets a system of attribute flags, which can be displayed using the `show`
+command with the parameter `vty-attributes`
+
+.Example: Typing `show vty-attributes` at the VTY prompt
+----
+OsmoBSC> show vty-attributes
+ Global attributes:
+ ! This command applies immediately
+ @ This command applies on VTY node exit
+ Library specific attributes:
+ A This command applies on ASP restart
+ I This command applies on IPA link establishment
+ L This command applies on E1 line update
+ Application specific attributes:
+ o This command applies on A-bis OML link (re)establishment
+ r This command applies on A-bis RSL link (re)establishment
+ l This command applies for newly created lchans
+----
+
+The attributes are symbolized through a single ASCII letter (flag) and do exist
+in three levels. This is more or less due to the technical aspects of the VTY
+implementation. For the user, the level of an attribute has only informative
+purpose.
+
+The global attributes, which can be found under the same attribute letter in every
+osmocom application, exist on the top level. The Library specific attributes below
+are used in various osmocom libraries. Like with the global attributes the attribute
+flag letter stays the same throughout every osmocom application here as well. On
+the third level one can find the application specific attributes. Those are unique
+to each osmocom application and the attribute letters may have different meanings
+in different osmocom applications. To make the user more aware of this, lowercase
+letters were used as attribute flags.
+
+The `list` command with the parameter `with-flags` displays a list of available
+commands on the current VTY node, along with attribute columns on the left side.
+Those columns contain the attribute flag letters to indicate to the user how the
+command behaves in terms of how and when the configuration change takes effect.
+
+.Example: Typing `list with-flags` at the VTY prompt
+----
+OsmoBSC(config-net-bts)# list with-flags
+ . ... help
+ . ... list [with-flags]
+ . ... show vty-attributes
+ . ... show vty-attributes (application|library|global)
+ . ... write terminal
+ . ... write file [PATH]
+ . ... write memory
+ . ... write
+ . ... show running-config
+ . ... exit
+ . ... end
+ . o.. type (unknown|bs11|nanobts|rbs2000|nokia_site|sysmobts)
+ . ... description .TEXT
+ . ... no description
+ . o.. band BAND
+ . .r. cell_identity <0-65535>
+ . .r. dtx uplink [force]
+ . .r. dtx downlink
+ . .r. no dtx uplink
+ . .r. no dtx downlink
+ . .r. location_area_code <0-65535>
+ . o.. base_station_id_code <0-63>
+ . o.. ipa unit-id <0-65534> <0-255>
+ . o.. ipa rsl-ip A.B.C.D
+ . o.. nokia_site skip-reset (0|1)
+ ! ... nokia_site no-local-rel-conf (0|1)
+ ! ... nokia_site bts-reset-timer <15-100>
+----
+
+There are multiple columns because a single command may be associated with
+multiple attributes at the same time. To improve readability each flag letter
+gets a dedicated column. Empty spaces in the column are marked with a dot (".")
+
+In some cases the listing will contain commands that are associated with no
+flags at all. Those commands either play an exceptional role (interactive
+commands outside "configure terminal", vty node navigation commands, commands
+to show / write the config file) or will require a full restart of the overall
+process to take effect.
--
To view, visit https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/20522
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-Change-Id: If03e07f1f8e7e3c0166a00e3f395e2a46a9a7713
Gerrit-Change-Number: 20522
Gerrit-PatchSet: 1
Gerrit-Owner: dexter <pmaier at sysmocom.de>
Gerrit-MessageType: newchange
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20201009/d6bfa69f/attachment.htm>