bettercap / website Goto Github PK

Description of the improvement

I recommend adding the following line to the documentation to help RPM users prep dependencies and ease the installation/upgrade process just to avoid frustrations.

sudo dnf install golang git kernel-devel-`uname -r` libpcap-14 libpcap-devel libusb-1 libusb-devel libnetfilter_queue-devel

The Short and sweet

The short version is that I would like to suggest an improvement to the documentation to give some guidance to RPM distro users that don't rely on package managers. Specifically, it would be nice for the documentation to recommend the following command as part of the dependency installation process for Fedora/CentOS/RHEL users.

DEB-based apt install as shown in the documentation:
sudo apt install golang git build-essential libpcap-dev libusb-1.0-0-dev libnetfilter-queue-dev

RPM-based dnf/yum install which performs the equivalent operation:
sudo dnf install golang git kernel-devel-`uname -r` libpcap-14 libpcap-devel libusb-1 libusb-devel libnetfilter_queue-devel

The following is a more verbose/extraneous explanation for my suggestion and the issues that came about in hopes that it will help users resolve similar problems to what I ran into.

Environment

Some environment information for context & replication if necessary

Fedora 29 - Linux kernel 5.0.10-200 - AMD64 (x86_64) arch
Go Version: 1.11.7
Previous bettercap version: Bettercap v2.11
Attempted to upgrade to: Bettercap v2.24

Reasons why

I ran into a lot of problems during what would ordinarily be a simple upgrade process. It's probably due to my lack of critical thinking skills and coffee while attempting to upgrade at 2am, but I spent a good hour or two trying to upgrade/reinstall bettercap. The problem was due to a change in the libusb dependencies going from bettercap v2.11 to v2.24. This caused the go get -u github.com/bettercap/bettercap method to fail silently during the build process. It wasn't until I completely blew away the bettercap src directory that the real problem surfaced:

go get -u github.com/bettercap/bettercap

# pkg-config --cflags  -- libusb-1.0
Package libusb-1.0 was not found in the pkg-config search path.
Perhaps you should add the directory containing `libusb-1.0.pc'
to the PKG_CONFIG_PATH environment variable
Package 'libusb-1.0', required by 'virtual:world', not found
pkg-config: exit status 1

I realize now that I should have turned on verbose output, and I would have come to this conclusion sooner. After some more troubleshooting, I eventually realized that I didn't even have the development packages installed, yet somehow bettercap worked/installed easily for me back when 2.11 was the latest version. After running the following, all was well.

sudo dnf install libpcap-devel libusb-devel
go get -u github.com/bettercap/bettercap/
cd $GOPATH/github.com/bettercap/bettercap/
make build
sudo make install

Maybe this issue was unnecessary, but hopefully it helps others in the future to avoid similar pitfalls. I will happily close on request, hopefully after the documentation has been amended.

Stop abusing the issue tracker.

Originally posted by @buffermet in bettercap/bettercap#857 (comment)

On the website, in Compiling from Sources it is indicated than version above 1.8 of go is required.

But following these instructions with go 1.11, the build will fail.

$ go version                           
go version go1.11.6 linux/amd64

$ go get github.com/bettercap/bettercap
package crypto/ed25519: unrecognized import path "crypto/ed25519" (import path does not begin with hostname)

When "Compiling From Sources" per website...

1. my $GOPATH (~/golang) was ignored,+ and ~/go was used
2. On a Raspberry Pi, the default swap space is insufficient and gcc fails. Maybe link to https://www.bitpi.co/2015/02/11/how-to-change-raspberry-pis-swapfile-size-on-rasbian/ where it explains how to increase swap

There is a typo mistake on this page of the documentation.

In the first paragraph there is a typo mistake for net.show which is written new.show