netadm 🔍

A CLI and client library to manage network devices written in Go.

CLI 🦾

Make sure to have Go installed and follow the instructions below to install it.

# go >= 1.17
# Using `go get` to install binaries is deprecated.
# The version suffix is mandatory.
go install github.com/nicklasfrahm/netadm@latest

# go < 1.17
go get github.com/nicklasfrahm/netadm

Below you may find the usage text of the command line interface.

A command line interface to manage network devices
via different protocols.

Note:
  To achieve a consistent behavior all operations
  are executed twice and the results are merged.
  This is done to work around operations that do
  not succeed if the device needs to refresh its
  ARP cache by performing a MAC address lookup of
  the host via the host IP. This happens on the
  the first interaction or, I assume, when the
  cache expires naturally, which appears to be
  every 5 minutes or so.

Usage:
  netadm [flags]
  netadm [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  get         Read configuration keys
  help        Help about any command
  if          List network interfaces
  keys        List available configuration keys
  scan        Scan for devices
  set         Write configuration keys

Flags:
  -h, --help               display help for command
  -r, --retries uint       number of retries to perform (default 1)
  -t, --timeout duration   timeout per attempt (default 100ms)

Use "netadm [command] --help" for more information about a command.

Configuration Items 🔧

References 🔗

Below, you may find a list of useful references that were used for this implementation.

• Netgear Switch Discovery Protocol on Wikipedia
• nmedb/nsdpy on Github
• tabacha/ProSafeLinux on Github
• rhulme/ProSafeLinux on Github

License 📄

This project is licensed under the terms of the MIT license.