diff options
author | Graeme Lunt <graeme.lunt@smhs.co.uk> | 2010-06-24 09:12:28 +0000 |
---|---|---|
committer | Graeme Lunt <graeme.lunt@smhs.co.uk> | 2010-06-24 09:12:28 +0000 |
commit | 25b20ff6ca79c87992675a1b64069b3421adfba6 (patch) | |
tree | 700027a22412cea8a555e7c73289e97081eca59f /doc/wireshark.pod.template | |
parent | 1b390de1dc82bbdd32afcbcbdd451a6884410e4d (diff) |
Update with documentation on the object identifier configuration files.
svn path=/trunk/; revision=33311
Diffstat (limited to 'doc/wireshark.pod.template')
-rw-r--r-- | doc/wireshark.pod.template | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/doc/wireshark.pod.template b/doc/wireshark.pod.template index 9707311cd7..f7e3178288 100644 --- a/doc/wireshark.pod.template +++ b/doc/wireshark.pod.template @@ -2584,6 +2584,68 @@ If the global F<colorfilters> file exists, it is used only if the personal F<colorfilters> file does not exist; global and personal color filters are not merged. +=item Object Identifiers + +The F<object identifier (OID)> files contain personal settings for the display of object +identifiers and the decoding of their associated values. + +They allow the user to: + +=over 4 + +=item * + +Add names and/or syntaxes for OIDs that Wireshark doesn't natively understand + +=item * + +Override the built-in OID names (e.g. change 'id-at-organization' to 'o') + +=item * + +Use a special syntax, "ASN.1", that allows a value associated with an OID +to be dissected as "unknown ber". (This is a effectively a selective +version of the "Decode unexpected tags as BER encoded data" BER option.) + +=back + +The configuration file is an ini style file, with the dotted OID used as +the section/group, and two keys defined, "name" and "syntax". + +The BER preferences page contains a configuration item for the OID files. A single +configuration file may be specified, or a directory may be specified. If a +directory is specified, then the files with a ".oid" extension will be loaded. + +An example configuration file: + + # a comment + [2.5.21.5] + name=attributeTypes + syntax=ASN.1 + [2.5.21.6] + name=objectClasses + [2.5.21.7] + name=nameForms + [1.2.840.10040.4.3] + name=id-dsa-with-sha1 + [2.5.4.6] + name=c + [2.5.4.10] + name=o + [2.5.4.11] + name=ou + [2.5.4.3] + name=cn + [1.3.32.0.2.0.4.66] + name=Unknown OID + syntax=PrintableString + [0.9.2342.19200300.100.1.10] + name=unknown dn + syntax=DistinguishedName + +The list of known syntaxes is shown in the "Decode As ..." dialog when +examining a BER file. + =item GTK rc files The F<gtkrc> files contain system-wide and personal GTK theme settings. |