| Lev Walkin | 3f12bc0 | 2005-03-10 15:09:02 +0000 | [diff] [blame^] | 1 | |
| 2 | GENERAL INFORMATION |
| 3 | =================== |
| 4 | |
| 5 | The GSM TAP3 (Transferred Account Procedure, Version 3) decoder. |
| 6 | Invoking `make` will compile the ASN.1 specifications from the |
| 7 | ../tap3.asn1 file. |
| 8 | |
| 9 | THERE IS NO tap3.asn1 FILE THERE YET! |
| 10 | |
| 11 | OBTAINING THE TAP3 SPECIFICATION |
| 12 | ================================ |
| 13 | |
| 14 | To obtain the TAP3 ASN.1 specification, you should go to |
| 15 | http://www.gsmworld.com/using/billing/tap3_legal.html |
| 16 | and agree with their licensing terms by clicking the "I ACCEPT" button. |
| 17 | |
| 18 | A .ZIP file with several Microsoft Word .DOC files will download shortly. |
| 19 | |
| 20 | You should extract the TAP-0311 ASN.1 module from one of these .DOC files |
| 21 | and save it as the ../tap3.asn1 file. The ../tap3.asn1 file should start with |
| 22 | the following line |
| 23 | "TAP-0311 DEFINITIONS IMPLICIT TAGS ::=" |
| 24 | and end with the "END" token. |
| 25 | Be careful not to copy any non-ASN.1 preambles from that .DOC file. |
| 26 | |
| 27 | After obtaining the tap3.asn1, type `make` in the directory containing |
| 28 | this README file. |
| 29 | |
| 30 | tap3dump USAGE |
| 31 | ============== |
| 32 | |
| 33 | The tap3dump utility may be used to dump the contents of the BER-encoded |
| 34 | TAP3 data record file: |
| 35 | |
| 36 | ./tap3dump -x tapfile.der # Print as XML (BASIC-XER) |
| 37 | |
| 38 | If necessary, a straightforward modification of the |
| 39 | ../../skeletons/asn-decoder-template.c |
| 40 | will allow you to build a converter from the XML (XER) TAP3 format |
| 41 | back into binary (BER). |
| 42 | |
| 43 | The full list of recognized command line options may be obtained with |
| 44 | |
| 45 | > ./tap3dump -h |
| 46 | Usage: ./tap3dump [options] <data.ber> ... |
| 47 | Where options are: |
| 48 | -b <size> Set the i/o buffer size (default is 8192) |
| 49 | -c Check ASN.1 constraints after decoding |
| 50 | -d Enable debugging (-dd is even better) |
| 51 | -n <num> Process files <num> times |
| 52 | -s <size> Set the stack usage limit |
| 53 | -p Print out the decoded contents |
| 54 | -x Print out as XML |
| 55 | |