174 lines
4.5 KiB
Groff
174 lines
4.5 KiB
Groff
|
|
.\" * OsmoGGSN - Gateway GPRS Support Node
|
|
.\" * Copyright (C) 2002, 2003 Mondru AB.
|
|
.\" *
|
|
.\" * The contents of this file may be used under the terms of the GNU
|
|
.\" * General Public License Version 2, provided that the above copyright
|
|
.\" * notice and this permission notice is included in all copies or
|
|
.\" * substantial portions of the software.
|
|
.\" *
|
|
.\" * The initial developer of the original code is
|
|
.\" * Jens Jakobsen <jj@openggsn.org>
|
|
.\" *
|
|
.\" * Contributor(s):
|
|
.\" *
|
|
.\" Manual page for osmo-ggsn
|
|
.\" SH section heading
|
|
.\" SS subsection heading
|
|
.\" LP paragraph
|
|
.\" IP indented paragraph
|
|
.\" TP hanging label
|
|
|
|
.TH osmo-ggsn 8 "August 2017"
|
|
.SH NAME
|
|
osmo-ggsn \- Gateway GPRS Support Node.
|
|
.SH SYNOPSIS
|
|
.B osmo-ggsn
|
|
\-\-help
|
|
|
|
.B osmo-ggsn
|
|
\-\-version
|
|
|
|
.B osmo-ggsn
|
|
[
|
|
.BI \-\-help
|
|
] [
|
|
.BI \-\-daemonize
|
|
] [
|
|
.BI \-\-config-file " file"
|
|
] [
|
|
.BI \-\-version
|
|
]
|
|
.SH DESCRIPTION
|
|
.B osmo-ggsn
|
|
is part of the
|
|
.B OsmoGGSN
|
|
project, and implements a Gateway GPRS Support Node. It is used by
|
|
mobile operators as the interface between the Internet and the rest of
|
|
the mobile network infrastructure.
|
|
|
|
The GPRS functionality and protocols has been standardised by the
|
|
Third Generation Partnership Project (3GPP). According to the 3GPP
|
|
specifications a GGSN has two interfaces: The Gn/Gp interface and the
|
|
Gi interface.
|
|
|
|
The Gn/Gp interface can be seen as the downlink interface of the
|
|
GGSN. It is used for communicating with the Serving GPRS Support Node
|
|
(SGSN) which again interfaces to the radio access network. The Gn/Gp
|
|
interface uses the GPRS tunneling protocol (GTP). User data packets
|
|
(typically IP packets) are tunneled over GTP, which again uses UDP
|
|
over IP.
|
|
|
|
The other interface can be thought of as the uplink interface, and
|
|
interfaces the GGSN to an external data network. Gi is most often an
|
|
interface to the Internet.
|
|
.B osmo-ggsn
|
|
uses the
|
|
.B TUN/TAP driver
|
|
for the Gi interface. A tun network interface is established when the
|
|
.B osmo-ggsn
|
|
is started.
|
|
|
|
.B osmo-ggsn
|
|
will accept incoming connections from mobile stations through the
|
|
radio access network and the SGSN. When a connection request is
|
|
received the ggsn will allocate a dynamic IP address for the mobile
|
|
station, and allow the mobile station to access the Gi
|
|
interface. Connections are terminated by either the mobile station or
|
|
the SGSN. Runtime errors are reported using the Osmocom logging
|
|
framework.
|
|
|
|
Typically
|
|
.B osmo-ggsn
|
|
will be deployed with two Ethernet interfaces. One for the Gn/Gp
|
|
interface, and one for the Gi interface. Policy routing and firewall
|
|
rules should be used in order to separate Gi traffic from Gn/Gp
|
|
traffic.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI --help
|
|
Print help and exit.
|
|
|
|
.TP
|
|
.BI --version
|
|
Print version and exit.
|
|
|
|
.TP
|
|
.BI --daemonize
|
|
Run in background as a daemon (default = off)
|
|
|
|
.TP
|
|
.BI --config-file " file"
|
|
Read configuration
|
|
.I file
|
|
(default = ./openggsn.cfg)
|
|
|
|
.SH FILES
|
|
.I ./osmo-ggsn.cfg
|
|
.RS
|
|
The configuration file for
|
|
.B osmo-ggsn.
|
|
.RE
|
|
.I /var/run/osmo-ggsn.pid
|
|
.RS
|
|
Process ID file.
|
|
.RE
|
|
.I /var/lib/osmo-ggsn
|
|
.RS
|
|
Directory holding nonvolatile data.
|
|
.RE
|
|
|
|
.SH BUGS
|
|
Report all bugs to the OsmoGGSN bug tracking list at
|
|
.I https://osmocom.org/projects/openggsn
|
|
|
|
.B osmo-ggsn
|
|
has very limited management support. Currently both SNMP as well as
|
|
billing mechanisms are missing.
|
|
|
|
|
|
.SH "SEE ALSO"
|
|
.BR sgsnemu (8)
|
|
|
|
.SH NOTES
|
|
.LP
|
|
|
|
Besides the long options documented in this man page
|
|
.B osmo-ggsn
|
|
also accepts a number of short options with the same functionality. Use
|
|
.B osmo-ggsn --help
|
|
for a full list of all the available options.
|
|
|
|
The TUN/TAP driver is required for proper operation of
|
|
.B osmo-ggsn.
|
|
For linux kernels later than 2.4.7 the TUN/TAP driver is included in the kernel, but typically needs to be loaded manually with
|
|
.B modprobe tun.
|
|
For automatic loading the line
|
|
.B alias char-major-10-200 tun
|
|
can be added to
|
|
.B /etc/modules.conf.
|
|
For other platforms see
|
|
.I http://vtun.sourceforge.net/tun/
|
|
for information on how to install and configure the tun driver.
|
|
|
|
.B osmo-ggsn
|
|
uses the GPRS Tunneling Protocol (GTP) as specified by the Third
|
|
Generation Partnership Project (3GPP). 3GPP protocols specifications
|
|
can be found at
|
|
.I http://www.3gpp.org
|
|
|
|
.SH COPYRIGHT
|
|
|
|
Copyright (C) 2002, 2003 by Mondru AB.
|
|
Copyright (C) 2017 Harald Welte
|
|
|
|
The contents of this file may be used under the terms of the GNU
|
|
General Public License Version 2, provided that the above copyright
|
|
notice and this permission notice is included in all copies or
|
|
substantial portions of the software.
|
|
|
|
.SH AUTHORS
|
|
Jens Jakobsen <jj@openggsn.org>
|
|
Harald Welte <laforge@gnumonks.org>
|