summaryrefslogtreecommitdiffstats
path: root/INSTALL.txt
blob: 6efe8d1f99b115f3b29ffd1d9a51ab8b60e1f0e6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
Dependencies needed, by example of a debian system:

apt-get install \
  make \
  asciidoc \
  asciidoc-dblatex \
  xsltproc \
  dblatex \
  docbook5-xml \
  mscgen \
  graphviz \
  python-pychart \
  python-nwdiag

(Note that asciidoc-dblatex is required from debian 9 on and did not exist before.)

Build PDFs, run:
  autoreconf -fi
  ./configure
  make

or for a parallel build using more CPU cores, replace make with:
  make -j 5

To update the VTY reference for a given program, use 'osmo_interact_vty.py -X',
available from git.osmocom.org/python/osmo-python-tests:

  cd ~/osmo-python-tests
  python3 setup.py install

  osmo_interact_vty.py -X -p $VTY_PORT > vty/*_vty_reference.xml

Find the VTY port number at
https://osmocom.org/projects/cellular-infrastructure/wiki/Port_Numbers

For example, for osmo-msc, which has VTY port 4254:

a) with an osmo-msc already running:

  osmo_interact_vty.py -X -p 4254 > OsmoMSC/vty/msc_vty_reference.xml

b) launching an osmo-msc along:

  osmo_interact_vty.py -r "osmo-msc -c ~/src/osmo-msc/doc/examples/osmo-msc/osmo-msc.cfg" \
    -X -p 4254 > OsmoMSC/vty/msc_vty_reference.xml

Note that docbook.org since recently are providing DTDs only on HTTPS URLs,
while xmllint is incapable of SSL. Hence it is necessary to locally install the
docbook DTDs. (On Debian, these are included in the docbook5-xml package.)