bluelog - manual de referência, opções, exemplos de comandos


NOME

bluelog Bluelog - Scanner e Logger Bluetooth

SINOPSE

bluelog -i [Interface] [Options] -o [Output File]
bluelog -help

DESCRIÇÃO

O Bluelog é um scanner Bluetooth simples projetado para fazer essencialmente apenas uma coisa: registrar todos os dispositivos detectáveis na área. Destina-se a ser usado como uma ferramenta de pesquisa do local, identificando o número de possíveis alvos Bluetooth existentes no ambiente circundante.

Escrevi Bluelog porque não parecia haver nenhum scanner Bluetooth para Linux que simplesmente registrasse dispositivos detectáveis sem também fazer um monte de outras coisas que eu realmente não precisava.

Claro, no final consegui expandir o Bluelog para fazer um monte de outras coisas que eu realmente não precisava. Mas pelo menos eu ainda mantive isso opcional, então você sempre pode ficar com o básico se isso for tudo que você quiser.

OPÇÕES BÁSICAS

-i <hci interface or MAC>

Esta opção informa ao Bluelog com qual dispositivo Bluetooth você deseja escanear. Você pode usar o nome do dispositivo HCI (como hci2) ou o MAC do adaptador local. Como bônus, se você fornecer um dispositivo que não existe, o Bluelog recorrerá à detecção automática para encontrar um dispositivo que funcione.

-o <filename>

Este é o nome de arquivo (opcional) do arquivo de log a ser gravado. O nome de arquivo padrão tem o formato "bluelog-YYYY-MM-DD-HHMM.log", localizado no diretório atual.

-v

Use esta opção para alternar a exibição de dispositivos encontrados no console. A saída detalhada também conterá informações de classe de dispositivo e registros de data e hora. O padrão é desabilitado.

-q

Desligue a saída do terminal não essencial. No modo normal, isso significa que você verá apenas a hora de início da varredura e a mensagem indicando o desligamento adequado. Quando usado com o modo daemon (-d), não haverá nenhuma saída de terminal. A única exceção a esta opção são os erros críticos, por razões óbvias.

-d

Esta opção irá daemonizar o Bluelog para que ele seja executado em segundo plano. Você ainda verá o clichê e as mensagens de inicialização, mas depois disso não verá mais nenhuma informação do Bluelog no terminal.

-k

Ao executar uma instância do Bluelog no modo daemon, a opção -k pode ser usada para eliminá-la.

-l

Esta opção alterna o Bluelog para o modo Live, que usa uma página da Web atualizada automaticamente para mostrar os resultados, em vez do console e dos arquivos de log regulares. Veja BLUELOG LIVE abaixo para mais detalhes.

OPÇÕES DE REGISTRO

-n

Use esta opção para alternar a exibição de nomes de dispositivos para dispositivos descobertos. Encontrar o nome do dispositivo leva mais tempo durante a verificação e ocasionalmente falha. Portanto, ao não resolver os nomes dos dispositivos, o Bluelog pode digitalizar com mais rapidez e precisão. O padrão é desabilitado.

-m

Esta opção, se habilitada na compilação, executa pesquisas de fabricante de hardware de dispositivos descobertos por meio do MAC OUI. O fabricante do hardware será registrado no arquivo de log padrão, assim como no Bluelog Live. O banco de dados do fabricante precisa ser instalado para que essa função funcione, o que o torna proibitivamente grande para algumas plataformas (como OpenWRT).

-c

Esta opção alterna a gravação da classe de dispositivo bruto no arquivo de log. A ativação dessa opção desativa a opção -f. O padrão é desabilitado.

-f

Essa opção pega a classe do dispositivo e a interpreta em um formato mais amigável. Ele informará a classe do dispositivo e também quais são seus principais recursos. Por exemplo, a classe 0x7a020c apareceria como: Smart Phone,(Net Capture Obex Audio Phone) A ativação desta opção desativa a opção -c. O padrão é desabilitado.

-t

Use esta opção para alternar a exibição de registros de data e hora para o início e o fim da verificação e para cada novo dispositivo encontrado no arquivo de log. O padrão é desabilitado.

-x

Use esta opção para alternar a ofuscação do endereço MAC. Com esta opção habilitada, o Bluelog exibirá a parte do fabricante de cada MAC descoberto, mas bloqueará o identificador específico do dispositivo. O padrão é desabilitado.

-e

Use esta opção para alternar a codificação de endereço MAC CRC32. Com esta opção habilitada, os endereços MAC descobertos nunca serão registrados no disco, ao contrário, cada dispositivo terá um ID exclusivo gerado para ele. Isso evita preocupações com a privacidade durante atividades como monitoramento de tráfego por Bluetooth. O padrão é desabilitado.

-b

Esta opção definirá o formato de log para que os dados resultantes sejam adequados para upload para o Projeto de Perfil Bluetooth do ronin (BlueProPro). Isso substitui a maioria das outras opções de registro e desativa o Bluelog Live. Para obter mais informações sobre este projeto e as etapas adicionais necessárias para enviar seus dados para inclusão, visite: www.hackfromacave.com

OPÇÕES AVANÇADAS

-r <retries>

Esta opção define quantas tentativas o Bluelog deve fazer para resolver um nome de dispositivo. Por vários motivos (link ruim, dispositivo ocupado etc.), os dispositivos nem sempre respondem a uma solicitação de nome em tempo hábil. Isso preenche os logs ou a exibição ao vivo com dispositivos sem nome que parecem, francamente, nada legais. Por padrão, o Bluelog fará 3 tentativas para resolver um nome de dispositivo, usando esta opção você pode definir que a contagem seja menor (mais rápida, mas menos precisa) ou maior (mais lenta, mas possivelmente mais precisa).

-a <minutes>

Esta opção ativa o "modo amnésia", que faz com que o Bluelog esqueça que viu um determinado dispositivo após um determinado período de tempo, dado aqui como minutos. Quando o Bluelog encontra um dispositivo que esqueceu através desta opção, ele o imprimirá nos logs novamente como se fosse a primeira vez que o viu. Um valor de zero fará com que o Bluelog registre continuamente um dispositivo o mais rápido possível (a velocidade real depende da plataforma em que o Bluelog está sendo executado).

-w <seconds>

Esta é uma opção experimental que permite ajustar quanto tempo o Bluelog instrui o BlueZ a procurar. De um modo geral, tempos de varredura mais curtos permitem que o Bluelog processe os dados recebidos mais rapidamente, mas requer mais poder de processamento. Tempos de varredura mais longos devem, teoricamente, funcionar melhor em hardware de ponta inferior.

-s

Use esta opção para alternar o modo somente syslog. Isso desativa o arquivo de log padrão e, em vez disso, grava novos dispositivos no arquivo de log do sistema. O padrão é desabilitado.

DIGITALIZAÇÃO BÁSICA

Não há muito a dizer sobre este. Inicie o Bluelog com as opções apropriadas e, em seguida, caminhe/dirija pela área e veja o que você encontra.

Para sua primeira verificação, tente algo simples como:

bluelog -vtn

Isso ativará a saída detalhada, registros de data e hora, nomes de dispositivos e saída para o arquivo padrão "devices.log". Existem várias outras opções que você pode usar para personalizar o nível de registro que o Bluelog fará, mas a maioria das pessoas provavelmente ficará satisfeita apenas com a hora, o MAC e o nome do dispositivo.

BLUELOG AO VIVO

Bluelog Live é uma interface alternativa para o Bluelog. Em vez de enviar os dispositivos descobertos para o console ou escrevê-los no arquivo de log esparso, o Bluelog criará uma página da Web com os resultados que você pode exibir para qualquer pessoa que queira olhar.

Para mais informações sobre o Bluelog Live, consulte o arquivo README.LIVE.

MODO DAEMON

A execução do Bluelog com a opção -d irá iniciá-lo no modo daemon, que o coloca em segundo plano. Este modo é especialmente útil ao executar o Bluelog Live.

Apenas uma instância do Bluelog pode ser executada por vez, portanto, se você tentar iniciar o Bluelog (no modo daemon ou interativo) enquanto ele já estiver sendo executado no modo daemon, você será solicitado a encerrar o processo existente. Você pode usar a opção -k para eliminar um processo Bluelog em execução ou simplesmente localizar o processo com ps e eliminá-lo manualmente.

Vale a pena notar que ativar o modo daemon também substitui algumas outras opções, como o modo detalhado (já que não há saída do terminal quando o Bluelog entra em segundo plano).

AUTOR

Tom Nardi - MS3FGX@gmail.com
www.digifail.com

ARQUIVOS

/usr/share/bluelog
/tmp/devices.log
/tmp/info.txt