Ouidata. A lookup tool for the Wireshark OUI database in Elixir.
Heavily inspired by the Tzdata library.
As of version 0.1.0 the current shipped database version is 20190416.
When a new release is out, it will be automatically downloaded at runtime.
The release version in use can be verified with the following function:
iex> Ouidata.ouidata_version
"20190416"
To use the Ouidata library with Elixir 1.8, add it to the dependencies in your mix file:
defp deps do
[ {:ouidata, "~> 0.1.0"}, ]
end
That's it!
Now you're able to search for OUI vendors and comments:
iex> Ouidata.get_vendor("00:00:69:AB:AB:AB")
"ConcordC"
iex> Ouidata.get_comment("00:00:69:AB:AB:AB")
"Concord Communications Inc"
The library uses a file directory to store data. By default this directory
is priv
. In some cases you might want to use a different directory. For
instance when using releases this is recommended. If so, create the directory and
make sure Elixir can read and write to it. Then use elixir config files like this
to tell Ouidata to use that directory:
config :ouidata, :data_dir, "/etc/elixir_ouidata_data"
Add the release_ets
directory from priv
to that directory
containing the 2019-xx-xx.ets
file that ships with this library.
For instance with this config: config :ouidata, :data_dir, "/etc/elixir_ouidata_data"
an .ets
file such as /etc/elixir_ouidata_data/release_ets/2019-04-15.ets
should be present.
By default Ouidata will poll for OUI database updates every day. In case new data is available, Ouidata will download it and use it.
This feature can be disabled with the following configuration:
config :ouidata, :autoupdate, :disabled
If the autoupdate setting is set to disabled, one has to manually put updated .ets files in the release_ets sub-dir of the "data_dir" (see the "Data directory and releases" section above). When Wireshark releases new versions of the time zone data, this Ouidata library can be used to generate a new .ets file containing the new data.
Documentation can be found at http://hexdocs.pm/ouidata/
Wireshark releases new versions of the OUI database frequently.
The new database will automatically be downloaded, parsed, saved and used in place of the old data.
The ouidata Elixir library is released under the MIT license. See the LICENSE file.
The OUI database file is released by Wireshark.