aboutsummaryrefslogtreecommitdiffstats
path: root/doc/manuals
diff options
context:
space:
mode:
authorVadim Yanitskiy <vyanitskiy@sysmocom.de>2021-04-16 07:02:49 +0200
committerlaforge <laforge@osmocom.org>2021-04-18 06:53:33 +0000
commit9cf65a7af500ffd8613f428fb944663f4da31cae (patch)
treecccd7ee0fc1e99e67a9c0b3097c83f35939d12a0 /doc/manuals
parent078682d7b5044fba269a0822bcbf08f66c196de2 (diff)
manuals: document new 'gsmtap-remote-host' command
Diffstat (limited to 'doc/manuals')
-rw-r--r--doc/manuals/chapters/configuration.adoc24
1 files changed, 17 insertions, 7 deletions
diff --git a/doc/manuals/chapters/configuration.adoc b/doc/manuals/chapters/configuration.adoc
index ede80eaa..f6ca75e1 100644
--- a/doc/manuals/chapters/configuration.adoc
+++ b/doc/manuals/chapters/configuration.adoc
@@ -108,11 +108,22 @@ them via UDP/IP. At that point, they can be captured with utilities like
*tcpdump* or *tshark* for further analysis by the *wireshark* protocol
analyzer.
-In order to activate this feature, you first need to make sure to start
-OsmoBTS using the `-i` or `--gsmtap-ip` command line option, specifying
-the destination IP address for the GSMTAP messages. In most cases,
-using 127.0.0.1 for passing the messages over the loopback (`lo`) device
-will be sufficient.
+In order to activate this feature, you first need to make sure to specify
+the remote address of _GSMTAP_ host in the configuration file. In most
+cases, using 127.0.0.1 for passing the messages over the loopback (`lo`)
+device will be sufficient:
+
+.Example: Enabling GSMTAP Um-frame logging to localhost
+----
+bts 0
+ gsmtap-remote-host 127.0.0.1 <1>
+----
+<1> Destination address for _GSMTAP_ Um-frames
+
+NOTE: Changing this parameter at run-time will not affect the existing
+_GSMTAP_ connection, full program restart is required.
+
+NOTE: Command line parameters `-i` and `--gsmtap-ip` have been deprecated.
OsmoBTS can selectively trace such messages by their L1 SAPI, for both
Rx and Tx. For a complete list of L1 SAPI values, please refer to the
@@ -153,8 +164,7 @@ bts 0
From the moment they are enabled via VTY, GSMTAP messages will be
generated and sent in UDP encapsulation to the IANA-registered UDP port
-for GSMTAP (4729) at the IP address specified in the command line
-argument.
+for GSMTAP (4729) of the specified remote address.
==== Configuring power ramping