Project

General

Profile

Actions

Bug #4848

open

osmo-bsc user manual shows tables with per-bts counters three (!) times

Added by laforge over 3 years ago. Updated about 2 years ago.

Status:
Feedback
Priority:
Normal
Assignee:
Category:
-
Target version:
-
Start date:
11/04/2020
Due date:
% Done:

0%

Spec Reference:

Description

The current PDF file (attached for reference) contains the "implemented counters" three times. Tables 8 + 9 appear to be identical copies of Table 7.


Files

osmobsc-usermanual.pdf View osmobsc-usermanual.pdf 1.54 MB laforge, 11/04/2020 04:13 PM

Related issues

Related to Cellular Network Infrastructure - Feature #4073: try to get counter and vty reference information at compile timeStalledHoernchen06/21/2019

Actions
Related to Cellular Network Infrastructure - Bug #3417: show asciidoc counters does not show all the counters availableNewosmith07/25/2018

Actions
Actions #1

Updated by laforge over 3 years ago

  • Related to Feature #4073: try to get counter and vty reference information at compile time added
Actions #2

Updated by laforge over 3 years ago

  • Related to Bug #3417: show asciidoc counters does not show all the counters available added
Actions #3

Updated by fixeria about 2 years ago

I had a quick look, and first of all I must say that the current rate counter tables are quite dated:

These counters and their description based on OsmoBSC 1.4.0.84-3f1f8 (OsmoBSC).

commit 3f1f857378e3af0417bdd9e2581efc12970fb4c3
Date:   Tue May 21 15:21:43 2019 +0200

The problem is that this part of documentation is not generated automatically and requires running doc/manuals/regen_doc.sh manually.

My initial assumption was that we see three per-BTS counter tables due to a bug in libosmocore that could have been fixed already, so I regenerated doc/manuals/chapters/counters_generated.adoc using osmo_interact_vty.py and checked the result. Unfortunately, duplication is still the case, with the only difference that I see two copies of per-BTS counter tables.

These two copies are there because struct bts_ctrg_desc is registered at least two times:

$ git grep bts_ctrg_desc
src/osmo-bsc/bsc_init.c:    net->bts_unknown_ctrs = rate_ctr_group_alloc(net, &bts_ctrg_desc, BTS_STAT_IDX_UNKNOWN);
src/osmo-bsc/bts.c:         bts->bts_ctrs = rate_ctr_group_alloc(bts, &bts_ctrg_desc, bts->nr);
...

and rate_ctr_for_each_group() does not distinguish between them.

Actions #4

Updated by fixeria about 2 years ago

  • Status changed from New to Feedback
  • Assignee changed from daniel to fixeria

Here is a simple workaround:

https://gerrit.osmocom.org/c/libosmocore/+/27409 VTY: avoid printing duplicate rate_ctr/stat_item groups [NEW]

Comments and ideas are welcome.

Actions

Also available in: Atom PDF

Add picture from clipboard (Maximum size: 48.8 MB)