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/.
Harald Welte gerrit-no-reply at lists.osmocom.orgReview at https://gerrit.osmocom.org/3849 Documentation update: Remove NEWS, README.Solaris, update README.md * README.Solaris is obsolete and related code has been removed * NEWS file was unmaintained for more than a decade, remove it * Remove "Performance" chapter about 550MHz Athlon * gengetopt is no longer needed for ggsn * remove compilation/installation instructions horribly out of date * command line syntax of 'ggsn' program has changed Change-Id: I45d627911503c7b733cae6a1396ca4d69a9994db --- M Makefile.am D NEWS D README.Solaris M README.md 4 files changed, 3 insertions(+), 240 deletions(-) git pull ssh://gerrit.osmocom.org:29418/openggsn refs/changes/49/3849/1 diff --git a/Makefile.am b/Makefile.am index 970fbf7..00091ef 100644 --- a/Makefile.am +++ b/Makefile.am @@ -10,4 +10,4 @@ dist-hook: echo $(VERSION) > $(distdir)/.tarball-version -EXTRA_DIST = git-version-gen .version README.md README.FreeBSD README.MacOSX README.Solaris +EXTRA_DIST = git-version-gen .version README.md README.FreeBSD README.MacOSX diff --git a/NEWS b/NEWS deleted file mode 100644 index b1352a5..0000000 --- a/NEWS +++ /dev/null @@ -1,78 +0,0 @@ -OPENGGSN NEWS -============= - -OpenGGSN - Gateway GPRS Support Node -Copyright (C) 2002, 2003, 2004 Mondru AB. - -Version 0.84 -============ - -* Initial MAC OSX support (Thanks to Pekka Nikander) -* Quality assurance and improved error logging (Thanks to Pekka - Nikander and Jonny Winberg) - -Version 0.83 -============ - -* Added selection mode and charging characteristics option to sgsnemu. -* Bug fixes on charging characteristics and PPP PCO length.(Thanks to - Loic Bernable <leto at vilya.org>). -* Improved Solaris support, hash table bugfix and improved logging. - -Version 0.82 -============ - -* Improved Solaris support. -* Routing manipulation and IP address alias capability for FreeBSD. -* Initial Debian port (Thanks to ARAKI Yasuhiro <ar at debian.org>). - -Version 0.81 -============ - - * Initial FreeBSD port (Thanks to Pavel Andreev <pavel.andreev at hp.com>). - * IMSI '1111' bugfix (Thanks to Pavel Andreev <pavel.andreev at hp.com>). - -Version 0.8 -=========== - - * Support for compilation under Solaris. - * Iptables firewall script. - * New options for sgsnemu - - -Version 0.7 -=========== - - * Support for GTP1. Currently without support for the secondary pdp - context activation procedure. - * sgsnemu will first attempt to use GTP1. If that fails it will - fallback to using GTP0. - * Standards compliance document. - -Version 0.6 -=========== - - * Improved README file. - * Now uses ioctl instead of ifconfig and route in ggsn and sgsnemu. - * Absolute path to gtp library in ggsn/Makefile.am and ggsn/Makefile.am - * Compiles with gengetopt 2.8 (Thanks to Lorenzo Bettini <bettini at gnu.org>) - * sgsnemu is now able to handle several contexts and allocate - interface IP addresses for each context. - * ggsn now supports protocol configuration option DNS - addresses. This allow mobile stations to set up DNS based on - information configured in the ggsn. - * Ping facility in sgsnemu allow testing without the need to route - packets through the tun interface. - * Man pages for ggsn and sgsnemu. - * Sys 5 init script. - * Spec file for building binary RPM packages. - * If not --createif exit after "ping" or "echo" finishes - * If sgsnemu echo failure, exit with code != 0 - - -Version 0.5 -=========== - - * Initial release. See README file for installation and usage - instructions. - diff --git a/README.Solaris b/README.Solaris deleted file mode 100644 index 2ac6dbc..0000000 --- a/README.Solaris +++ /dev/null @@ -1,41 +0,0 @@ -OpenGGSN/Solaris notes -====================== - -Solaris support is experimental, please test and report bugs. The -Solaris port is tested under Solaris 8. - -Compiling ---------- - -You need to edit the following line in ggsn/Makefile.in and -sgsnemu/Makefile.in: - -LDFLAGS = -Wl,--rpath -Wl,/usr/local/lib @EXEC_LDFLAGS@ - -should be changed to: - -LDFLAGS = -lresolv -lsocket -lnsl @EXEC_LDFLAGS@ - -After this you install by the following commands: -./configure -make -make install - - -TUN ---- - -You might or might not need to install the tun driver manually. For -general information about tun see http://vtun.sourceforge.net/tun/ - - -Known problems --------------- - -Currently multiple IP addresses on the same network interface is not -implemented for Solaris. - -Currently routing table manipulation is not implemented for -Solaris. You have to set the routes manually after you start ggsn or -sgsnemu. - diff --git a/README.md b/README.md index 8e4ceae..829adcd 100644 --- a/README.md +++ b/README.md @@ -174,26 +174,6 @@ will fallback to GTPv0. -Performance -=========== - -Two experiments were performed in order to test the performance of -sgsnemu and ggsn. The ggsn used a 550 MHz Athlon with 384 MB of -RAM. sgsnemu used a 1 GHz Athlon with 256 MB of RAM. Both machines had -100 Mb/s NICs (RTL-8139) and were connected through a crossed patch -cable. Both tests were performed by sending ICMP echo packets from -sgsnemu to the ggsn. - -89.5 Mb/s IP throughput when sending 10000 ICMP ping packets with a -payload of 1400 bytes. Transfer time 1.27 sec, no packets lost. - -71.4 Mb/s IP throughput when sending 10000 ICMP ping packets with a -payload of 1000 bytes. Transfer time 1.15 sec, no packets lost. - -12,1 Mb/s IP throughput when sending 10000 ICMP ping packets with a -payload of 100 bytes. Transfer time 0.84 sec, no packets lost. - - Required software ================= @@ -209,19 +189,12 @@ Alternatively you can execute "modprobe tun" on the commandline. -For Solaris the tun driver needs to be installed manually. For general -information about tun see http://vtun.sourceforge.net/tun/ - Gengetopt --------- Gengetopt is required if you want to change the options defined in the cmdline.ggo source file. You need at least gengetopt version 2.8. If you are just going to compile the programs you don't need gengetopt. - -To use gengetopt for the ggsn do the following: -cd ggsn -gengetopt < cmdline.ggo --conf-parser To use gengetopt for the sgsnemu do the following: cd sgsnemu @@ -234,98 +207,7 @@ Compilation and Installation ============================ - -Setting up autotools --------------------- - -You do not need to perform this step if you are only going to compile -the package: - -1. Get version from somewhere: Script to extract version from configure.in -2. Copy the latest config.guess and config.sub from ftp://ftp.gnu.org/gnu/config -3. Run autoscan and copy configure.scan to configure.in -4. Add/edit the following lines in configure.in: - - AC_INIT(openggsn, 0.70, jj at openggsn.org) - - AC_CONFIG_SRCDIR([gtp/gtp.c]) - - AM_CONFIG_HEADER([config.h]) - - AC_PROG_LIBTOOL - - AM_PROG_LIBTOOL - - AM_INIT_AUTOMAKE() -5. libtoolize --automake --copy - (ads copy of ltmain.sh) -6. aclocal -7. autoheader -8. automake --add-missing --copy - (Ads copy of mkinstalldirs missing, install-sh, depcomp) -9. automake -10. autoconf - -The above will initialise the project to the current version of -autotools (As installed in RedHat 8.0). See -http://sources.redhat.com/autobook/autobook/autobook_25.html#SEC25 -for details on autotools. - - -Checking out from CVS ---------------------- - -To download the latest source code from anonymous CVS: - -cvs -d:pserver:anonymous at cvs.sourceforge.net:/cvsroot/ggsn login -cvs -z3 -d:pserver:anonymous at cvs.sourceforge.net:/cvsroot/ggsn co openggsn - -Or to download from developer CVS: - -export CVS_RSH=ssh -cvs -z3 -d:ext:developername at cvs.sourceforge.net:/cvsroot/ggsn co openggsn - -Both the above sets of commands creates a new directory called openggsn. - - -Compilation and installation ----------------------------- - -If compiling under Solaris you need to edit the following line in -ggsn/Makefile.in and sgsnemu/Makefile.in: - -LDFLAGS = -Wl,--rpath -Wl,/usr/local/lib @EXEC_LDFLAGS@ - -should be changed to: - -LDFLAGS = -lresolv -lsocket -lnsl @EXEC_LDFLAGS@ - -Note that the above is not necessary on other platforms. Compilation -and installation is performed by the following steps: - - 1. ./configure - 2. make clean - 3. cd gtp - 4. make - 5. make install (as root) - 6. cd .. - (Step 3 to 6 you only need to run the first time to install libgtp) - 7. make - 8. make install (as root) - 9. Add /usr/local/lib to /etc/ld.so.conf -10. run ldconfig - -(Steps 9 and 10 are not required as path to libgtp is included in Makefile) - -Documentation can be converted to html by issuing: - - 1. txt2html -pm -tf README > README.html - 2. txt2html -pm -tf NEWS > NEWS.html - 3. man2htm ggsn.8 > ggsn.html - 4. man2htm sgsnemu.8 > sgsnemu.html - - -Installation from binary ------------------------- - -1. rpm -i openggsn-<version>.rpm - -This will install binaries, man pages, configuration files as well as -a Sys V init script for the ggsn. +Please refer to the project homepage Running ggsn @@ -337,7 +219,7 @@ Start the ggsn as root using the command: -ggsn -c examples/ggsn.conf --fg -l 10.0.0.40 --net 192.168.0.0/24 --dynip 192.168.0.0/24 +ggsn -c examples/ggsn.conf First a tun network interface will be created. In the above example the network interface address is 192.168.0.0 and the mask is -- To view, visit https://gerrit.osmocom.org/3849 To unsubscribe, visit https://gerrit.osmocom.org/settings Gerrit-MessageType: newchange Gerrit-Change-Id: I45d627911503c7b733cae6a1396ca4d69a9994db Gerrit-PatchSet: 1 Gerrit-Project: openggsn Gerrit-Branch: master Gerrit-Owner: Harald Welte <laforge at gnumonks.org>