The CoralReef Software Suite includes a number of applications that require external data in order to perform such tasks as mapping TCP and UDP port numbers to applications or finding the name of a country given its ISO or FIPS country code. While all of these applications give the user the option of using their own data file, complete data files are also provided so that users who are satisfied with the default files can use these CoralReef applications without any additional hassle. Between CoralReef releases the data contained in these files may change, so we strongly suggest that users verify that the data files are up-to-date before using them.
The CoralReef data file documentation is organized by the application that uses the documented data file.
The Application_ports_Master.txt file contains all of the rules that the AppPorts.pm module needs to map a TCP or UDP port or an ICMP type and code to a network application. The file consists of lists of records from which AppPorts.pm can select a match. For a complete list of the applications matched in our default file, please refer to the application groups documentation. Each application record contains the following fields:
a category for organizing applications, possibly in directory structures, or for aggregating simular applications. must be able to be used as a UNIX filename. defaults to an empty string.
Note: The group names used in Application_ports_Master.txt have changed for CoralReef 3.6 and future versions. The new groups are documented in application_ports_groups. If you wish to continue to use the old groups, please refer to Obsolete_application_ports.txt, below.
An example entry for the World Wide Web would be:
description: World Wide Web name: WWW group: WWW srcnet: 0.0.0.0/0 dstnet: 0.0.0.0/0 ports_ok: 1 sport: 80,8080 dport: * sym: 1 protocol: 6 priority: 50 contributor: bigj date: 1999-07-08 notes: reference: IANA Port assignments url: http://www.iana.org/assignments/port-numbers
Note that srcnet and dstnet can (and should) be omitted, since they default to matching all subnets. The notes and priority are similarly the same as the default.
If one wanted to override this rule with a domain specific application, such a rule might look like:
description: Our non-web app name: APPFOO group: INTERNAL srcnet: 10.0.0.0/8 sport: 8080 dport: * sym: 1 protocol: 6 priority: 10
It is possible to create a rule to match all cases, as a fall-through. However, it must have a low priority if it is to be useful:
description: Unknown TCP name: UNKNOWN_TCP sport: * dport: * protocol: 6 priority: 90 description: Unknown name: UNKNOWN sport: * dport: * protocol: * priority: 100
The comment character for this file is #.
Note: The group names used in Application_ports_Master.txt have changed for CoralReef 3.6 and future versions. The new groups are documented in application_ports_groups. If you wish to continue to use the old groups, please refer to Obsolete_application_ports.txt, below.
See also: AppPorts
Obsolete_application_ports.txt is the old version of Application_ports_Master.txt released with versions of CoralReef prior to version 3.6. The formatting of Obsolete_application_ports.txt is identical to that of Application_ports_Master.txt; the only difference between the two files is that the group definitions changed for CoralReef version 3.6. The new groups are described in application_ports_groups.
Obsolete_application_ports.txt is included in the CoralReef for anyone who wishes to preserve the old group mappings.
Countries is a module that lets you look up information on countries, continents, and country locations. It is meant to provide general, relatively static information. It does not map latitude and longitude to a specific country, but it does map a country name to the latitude and longitude of its geographic center.
The comment character for all files read by Countries.pm is #.
File mapping continent codes to continent names. The
file entries should be formatted as:
"continent-code
For example:
sa South America eu Europe
File mapping ISO 2-letter country codes to FIPS country
codes. The file entries should be formatted as:
"ISO-2-letter-code
For example:
ad an ae tc af af ag ac ai av al al am am an nt ao ao as aq
File mapping ISO 2-letter country codes to the full name
of the country. A name in parentheses indicates an
alternate name for that country. A name in square
brackets indicates an optional addition (usually a
prefix) to the existing name. The file entries should
be formatted as:
"ISO-2-letter-code
For example:
uy Uruguay uz Uzbekistan va Holy See (Vatican City State) vc Saint Vincent & Grenadines ve Venezuela vg British Virgin Islands vi Virgin Islands [US] vn Vietnam vu Vanuatu
File mapping ISO 2-letter country codes to the ISO
3-letter country codes. The file entries should be
formatted as: "ISO-2-letter-code
For example:
ad and ae are af afg ag atg ai aia al alb am arm an ant ao ago ar arg as asm
File mapping ISO 2-letter country codes to the continent
containing that country and the latitude and longitude
of the center of the country. The file entries should
be formatted as:
"ISO-2-letter-code
For example:
ad eu 42.50,1.50 ae as 24.00,54.00 af as 33.00,65.00 ag na 17.05,-61.80 ai na 18.22,-63.05 al eu 41.00,20.00 am as 40.00,45.00 an na 12.17,-69.00 ao af -12.50,18.50 aq aq -77.85,166.67 ar sa -34.00,-64.00 as oc -14.32,-170.50
See also: Countries