
GENERAL INFORMATION
===================

The GSM TAP3 (Transferred Account Procedure, Version 3) decoder.
Invoking `make` will compile the ASN.1 specifications from the
../tap3.asn1 file.

THERE IS NO tap3.asn1 FILE THERE YET!

OBTAINING THE TAP3 SPECIFICATION
================================

To obtain the TAP3 ASN.1 specification, you should go to
	http://www.gsmworld.com/using/billing/tap3_legal.html
and agree with their licensing terms by clicking the "I ACCEPT" button.

A .ZIP file with several Microsoft Word .DOC files will download shortly.

You should extract the TAP-0311 ASN.1 module from one of these .DOC files
and save it as the ../tap3.asn1 file. The ../tap3.asn1 file should start with
the following line
	"TAP-0311 DEFINITIONS IMPLICIT TAGS ::="
and end with the "END" token.
Be careful not to copy any non-ASN.1 preambles from that .DOC file.

After obtaining the tap3.asn1, type `make` in the directory containing
this README file.

tap3dump USAGE
==============

The tap3dump utility may be used to dump the contents of the BER-encoded
TAP3 data record file:

	./tap3dump -x tapfile.der	# Print as XML (BASIC-XER)

If necessary, a straightforward modification of the
	../../skeletons/asn-decoder-template.c
will allow you to build a converter from the XML (XER) TAP3 format
back into binary (BER).

The full list of recognized command line options may be obtained with

	> ./tap3dump -h
	Usage: ./tap3dump [options] <data.ber> ...
	Where options are:
	  -b <size>    Set the i/o buffer size (default is 8192)
	  -c           Check ASN.1 constraints after decoding
	  -d           Enable debugging (-dd is even better)
	  -n <num>     Process files <num> times
	  -s <size>    Set the stack usage limit
	  -p           Print out the decoded contents
	  -x           Print out as XML