Osmocom Top-level Makefile and dev tools
Go to file
Neels Hofmeyr 1c1e4d2b75 gen_makefile: improve detect-edits dependency
Put the list of files to monitor directly in the makefile dependencies instead.
Now it finally works for 'make -j'.

Change-Id: Ie9b8c52bffcced4c8e482b43f6f9b5fdd93f61aa
2017-09-11 05:24:45 +02:00
src git_branch_summary.py: add usage, make py3 compatible 2017-09-04 15:02:23 +02:00
.gitignore add src scripts 2017-08-22 15:58:51 +02:00
2G.deps 2G deps: add missing dep sgsn -> sccp 2017-09-09 17:33:17 +02:00
3G+2G.deps use osmo-ggsn.git, no longer openggsn 2017-09-07 00:51:30 +02:00
README Revert "move iu.opts to no-iu.opts, change to --disable-iu" 2017-09-06 18:57:30 +02:00
all-tests.opts add all-tests.opts, including vty tests, drop external-tests.opts 2017-08-23 01:29:54 +02:00
default.opts gen_makefile: allow combining several .opts files 2017-08-22 19:27:08 +02:00
gen_makefile.py gen_makefile: improve detect-edits dependency 2017-09-11 05:24:45 +02:00
iu.opts Revert "move iu.opts to no-iu.opts, change to --disable-iu" 2017-09-06 18:57:30 +02:00
osmo-uninstall.sh add osmo-uninstall.sh 2017-08-23 00:13:33 +02:00
transcoding.opts fix transcoding.opts: osmo-bsc also needs it ATM 2017-08-22 19:34:02 +02:00

README

=== gen_makefile.py

This provides a set of top-level makefiles to build variants of the Osmocom
source trees. It is inteded for the core network components and related
projects, but works generically.

The idea is to have all your Osmocom git clones in ./src, while keeping one or
more separate build trees in ./make-*.

Run ./gen_makefile.py with a choice of projects (2G only or also 3G?)
and a choice of configure options.

Examples:

Full 2G and 3G support:

  ./gen_makefile.py 3G+2G.deps default.opts iu.opts

2G only (requires to pass no-iu.opts), and a custom dir name of 'make-2G':

  ./gen_makefile.py 2G.deps default.opts -m make-2G

This generates a new dir containing a Makefile. When you run make in it, this
will clone the source trees (if not present yet) and build all of them in the
right order:

  cd make-3G+2G-default+iu
  make

If you make modifications in one of the source trees, this Makefile will pick
it up, rebuild the project and also rebuild all dependencies (according to the
*.deps file the Makefile was generated from).

If you modify the *.deps or *.opts file, you can easily run 'make regen' in a
make-* subdir to regenerate the Makefile from the same files.

In your make-* subdir there are empty status files that are touched for every
completed make target. From these, 'make' can detect what needs to be rebuilt.
You can manually remove them to force a rebuild of a specific target.

For example, if you 'rm .make.libosmocore.autoconf', libosmocore and all
projects depending on libosmocore will be rebuilt from scratch.

For more details on the *.opts and *.deps syntax, read the docs at the top of
./gen_makefile.py.

It is also easily possible to keep sources and build trees in various
configurations, see the command line options of ./gen_makefile.py.


=== osmo-uninstall.sh

Remove osmocom built binaries and headers from given prefix,
default is /usr/local.


=== src/*

Find other useful scripts in src/, see src/README.