User Guide

Files and Folders
207
[location data] Optional. Contains keys that will be used for variable substitution in the
"location" value. For example, if the database section contains
location = http://www.example.com/proto?cookie=${cookie}&path=${PATH}
then setting
cookie = anonymous-user-1138
will result in the URL "http://www.example.com/proto?cookie=anonymous-
user-1138&path=${PATH}". PATH is used for help path substitution, and
shouldn't be defined in this section.
[map] Maps Wireshark protocol names to section names below. Each key MUST match
a valid protocol name such as "ip". Each value MUST have a matching section
defined in the configuration file.
Each protocol section must contain an "_OVERVIEW" key which will be used as the first menu item
for the help source. Subsequent keys must match descriptions in the protocol detail. Values will be used
as the ${PATH} variable in the location template. If ${PATH} isn't present in the location template the
value will be appended to the location.
Suppose the file C:\Users\sam.clemens\AppData\Roaming\Wireshark
\protocol_help\wikipedia.ini contains the following:
# Wikipedia (en) protocol help file.
# Help file initialization
# source: The source of the help information, e.g. "Inacon" or "Wikipedia"
# version: Currently unused. Must be "1".
# url_template: Template for generated URLs. See "URL Data" below.
[database]
source=Wikipedia
version=1
url_template=http://${language}.wikipedia.org/wiki/${PATH}
# Substitution data for the location template.
# Each occurence of the keys below in the location template will be
# substituted with their corresponding values. For example, "${license}"
# in the URL template above will be replaced with the value of "license"
# below.
#
# PATH is reserved for the help paths below; do not specify it here.
[location data]
language = en
# Maps Wireshark protocol names to section names below. Each key MUST match
# a valid protocol name. Each value MUST have a matching section below.
[map]
tcp=TCP
# Mapped protocol sections.
# Keys must match protocol detail items descriptions.
[TCP]
_OVERVIEW=Transmission_Control_Protocol
Destination port=Transmission_Control_Protocol#TCP_ports
Source port=Transmission_Control_Protocol#TCP_ports