Skip to content
/ arpdb Public

A Ruby gem to query ARP database from network devices via SNMP

Notifications You must be signed in to change notification settings

jkvalk/arpdb

Repository files navigation

Build Status Gem Version Coverage Status Code Climate

Arpdb

Arpdb is a Ruby gem for querying SNMP-enabled network devices for their ARP database.

Installation

Add this line to your application's Gemfile:

gem 'arpdb'

And then execute:

$ bundle

Or install it yourself as:

$ gem install arpdb

Usage

require 'arpdb'
include Arpdb

hosts = %w(10.40.5.1 10.43.5.1)
community = 'public'

adb = Arp.new( hosts.collect { |host| SNMPTransport.new(host, community) } ).scan

puts adb.mac_to_ip "7a70dec81b02"
puts adb.ip_to_mac "172.27.50.2"

puts adb.locate_mac "7a70dec81b02"
puts adb.locate_ip "172.27.50.2"

adb.rescan

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rspec spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/jkvalk/arpdb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

About

A Ruby gem to query ARP database from network devices via SNMP

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published