Este projeto está em manutenção passiva. Problemas críticos serão resolvidos, mas nenhum novo recurso está sendo desenvolvido. No entanto, isso se deve mais à falta de financiamento e/ou mão de obra do que qualquer outra coisa, então pull requests são mais que bem-vindos. Além disso, se você puder e estiver disposto a contribuir com este projeto a longo prazo, gostaríamos de convidá-lo a se candidatar para co-manutenção.

Para mais detalhes, veja O Futuro do Bandwhich #275.

How does it work?

bandwhich captura uma interface de rede fornecida e grava o tamanho dos pacotes IP, cruzando com o sistema de arquivos /proc no Linux, lsof no macOS ou usando WinApi no Windows. Ele é responsivo ao tamanho da janela do terminal, exibindo menos informações se não houver espaço. Também tentará resolver IPs para seus nomes de host em segundo plano usando DNS reverso no melhor esforço.

Installation

Downstream packaging status

Para instruções detalhadas para cada plataforma, veja INSTALL.md.

Download a prebuilt binary

Oferecemos vários binários genéricos em releases para vários sistemas operacionais.

Building from source

Para a versão mínima suportada do Rust mais atualizada, consulte o campo rust-version em Cargo.toml.

Cross-compiling

A compilação cruzada para destinos alternativos é suportada via cross. Aqui está o procedimento aproximado:

1. Verifique a arquitetura de destino. Se estiver no Linux, você pode usar uname -m.
2. Consulte o suporte de plataforma do rustc para o tripleto de destino correspondente.
3. Instale o cross.
4. Execute cross build --release --target <TRIPLETO_DE_DESTINO>.

Android

Até que cross-rs/cross#1222 seja resolvido, use a versão mais recente do HEAD:

Post install (Linux)

Como o bandwhich captura pacotes de rede, ele requer privilégios elevados. No Linux, existem duas maneiras principais de fazer isso:

1. setcap

• Permita permanentemente que o binário bandwhich tenha os privilégios necessários (chamados de "capabilities" no Linux).
• Faça isso se quiser dar a todos os usuários não privilegiados acesso total aos recursos de monitoramento do bandwhich.
  • Esta é a configuração recomendada para máquinas com um único usuário, ou se todos os usuários forem confiáveis.
  • Isso não é recomendado se você quiser garantir que os usuários não possam ver o tráfego de outros.

Capabilities explicadas

• cap_sys_ptrace,cap_dac_read_search: permite acesso a /proc/<pid>/fd/, para que o bandwhich possa determinar qual porta aberta pertence a qual processo.
• cap_net_raw,cap_net_admin: permite capturar pacotes no seu sistema.

2. sudo (ou alternativa)

• Exija elevação de privilégios a cada execução.
• Faça isso se você for administrador de um ambiente multiusuário.

Observe que se o seu método de instalação instalou o bandwhich em algum lugar do seu diretório home (você pode verificar com command -v bandwhich), você pode receber um erro command not found. Isso ocorre porque em muitas distribuições, o sudo por padrão não mantém o $PATH do seu usuário por questões de segurança.

Para contornar isso, você pode fazer uma das seguintes opções:

1. faça o sudo preservar sua variável de ambiente $PATH;
2. defina explicitamente $PATH ao executar o bandwhich: sudo env "PATH=$PATH" bandwhich;
3. passe o caminho completo para o sudo: sudo $(command -v bandwhich).

Post install (Windows)

Você pode precisar instalar primeiro o npcap para capturar pacotes no Windows.

Usage

Contributing

Veja CONTRIBUTING.md.

License

MIT