bluelog - manuel de référence, options, exemples de commandes


NOM

bluelog Bluelog - Scanner et enregistreur Bluetooth

SYNOPSIS

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

DESCRIPTION

Bluelog est un simple scanner Bluetooth conçu pour faire essentiellement une seule chose, enregistrer tous les appareils détectables dans la zone. Il est destiné à être utilisé comme un outil d'étude de site, identifiant le nombre de cibles Bluetooth possibles dans l'environnement environnant.

J'ai écrit Bluelog parce qu'il ne semblait pas y avoir de scanner Bluetooth pour Linux qui enregistrerait simplement les périphériques détectables sans faire également tout un tas d'autres choses dont je n'avais pas vraiment besoin.

Bien sûr, à la fin, j'ai réussi à étendre Bluelog en faisant tout un tas d'autres choses dont je n'avais pas vraiment besoin. Mais au moins, je l'ai toujours gardé en option, donc vous pouvez toujours vous en tenir aux bases si c'est tout ce que vous voulez.

OPTIONS DE BASE

-i <hci interface or MAC>

Cette option indique à Bluelog avec quel appareil Bluetooth vous souhaitez numériser. Vous pouvez utiliser le nom du périphérique HCI (comme hci2) ou le MAC de l'adaptateur local. En prime, si vous donnez un appareil qui n'existe pas, Bluelog se rabattra sur l'auto-détection pour trouver un appareil fonctionnel.

-o <filename>

Il s'agit du nom de fichier (facultatif) du fichier journal à écrire. Le nom de fichier par défaut a le format "bluelog-YYYY-MM-DD-HHMM.log", situé dans le répertoire courant.

-v

Utilisez cette option pour basculer l'affichage des appareils trouvés sur la console. La sortie détaillée contiendra également des informations sur la classe de périphérique et des horodatages. La valeur par défaut est désactivée.

-q

Désactivez la sortie de terminal non essentielle. En mode normal, cela signifie que vous ne verrez que l'heure de début de l'analyse et le message indiquant un arrêt correct. Lorsqu'il est utilisé avec le mode démon (-d), il n'y aura aucune sortie de terminal. La seule exception à cette option concerne les erreurs critiques, pour des raisons évidentes.

-d

Cette option démonisera Bluelog afin qu'il s'exécute en arrière-plan. Vous verrez toujours les messages passe-partout et de démarrage, mais après cela, vous ne verrez plus aucune information de Bluelog dans le terminal.

-k

Lors de l'exécution d'une instance de Bluelog en mode démon, l'option -k peut être utilisée pour la tuer.

-l

Cette option fait passer Bluelog en mode Live, qui utilise une page Web automatiquement mise à jour pour afficher les résultats plutôt que la console et les fichiers journaux habituels. Voir BLUELOG LIVE ci-dessous pour plus de détails.

OPTIONS D'ENREGISTREMENT

-n

Utilisez cette option pour basculer l'affichage des noms de périphérique pour les périphériques découverts. La recherche du nom du périphérique prend plus de temps lors de la numérisation et échoue parfois. Par conséquent, en ne résolvant pas les noms d'appareils, Bluelog peut analyser plus rapidement et plus précisément. La valeur par défaut est désactivée.

-m

Cette option, si elle est activée dans la version, effectue des recherches de fabricants de matériel sur les périphériques découverts via l'OUI MAC. Le fabricant du matériel sera enregistré dans le fichier journal standard, ainsi que Bluelog Live. La base de données du fabricant doit être installée pour que cette fonction fonctionne, ce qui la rend prohibitive pour certaines plates-formes (telles que OpenWRT).

-c

Cette option bascule l'écriture de la classe de périphérique brut dans le fichier journal. L'activation de cette option désactive l'option -f. La valeur par défaut est désactivée.

-f

Cette option prend la classe de périphérique et l'interprète dans un format plus convivial. Il vous indiquera à quelle classe appartient l'appareil et quelles sont ses principales capacités. Par exemple, la classe 0x7a020c apparaîtrait comme : Smart Phone,(Net Capture Obex Audio Phone) L'activation de cette option désactive l'option -c. La valeur par défaut est désactivée.

-t

Utilisez cette option pour basculer l'affichage des horodatages pour le début et la fin de l'analyse et pour chaque nouveau périphérique trouvé dans le fichier journal. La valeur par défaut est désactivée.

-x

Utilisez cette option pour basculer l'obscurcissement de l'adresse MAC. Avec cette option activée, Bluelog affichera la partie fabricant de chaque MAC découvert, mais bloquera l'identifiant spécifique à l'appareil. La valeur par défaut est désactivée.

-e

Utilisez cette option pour basculer l'encodage de l'adresse MAC CRC32. Avec cette option activée, les adresses MAC découvertes ne seront jamais enregistrées sur le disque, mais chaque périphérique aura un identifiant unique généré pour lui. Cela évite les problèmes de confidentialité lors d'activités telles que la surveillance du trafic Bluetooth. La valeur par défaut est désactivée.

-b

Cette option définira le format du journal afin que les données résultantes conviennent au téléchargement vers le projet de profilage Bluetooth de ronin (BlueProPro). Cela remplace la plupart des autres options de journalisation et désactive Bluelog Live. Pour plus d'informations sur ce projet et les étapes supplémentaires requises pour soumettre vos données pour inclusion, visitez : www.hackfromacave.com

OPTIONS AVANCÉES

-r <retries>

Cette option définit le nombre de tentatives que Bluelog doit faire pour résoudre un nom de périphérique. Pour diverses raisons (mauvais lien, appareil occupé, etc.), les appareils ne répondent pas toujours à une demande de nom en temps opportun. Cela remplit les journaux ou l'affichage en direct avec des appareils sans nom qui ont l'air, franchement, pas cool. Par défaut, Bluelog fera 3 tentatives pour résoudre un nom d'appareil, en utilisant cette option, vous pouvez définir ce nombre pour qu'il soit inférieur (plus rapide, mais moins précis) ou supérieur (plus lent, mais peut-être plus précis).

-a <minutes>

Cette option active le "mode amnésie", ce qui fait que Bluelog oublie qu'il a vu un appareil particulier après un certain temps, donné ici en minutes. Lorsque Bluelog rencontre un appareil qu'il a oublié grâce à cette option, il l'imprime à nouveau dans les journaux comme si c'était la première fois qu'il était vu. Une valeur de zéro obligera Bluelog à enregistrer en continu un appareil aussi rapidement que possible (la vitesse réelle dépend de la plate-forme sur laquelle Bluelog s'exécute).

-w <seconds>

Il s'agit d'une option expérimentale qui permet d'ajuster la durée pendant laquelle Bluelog demande à BlueZ de rechercher. De manière générale, des temps d'analyse plus courts permettent à Bluelog de traiter les données entrantes plus rapidement, mais nécessitent plus de puissance de traitement. Des temps d'analyse plus longs devraient théoriquement mieux fonctionner sur du matériel bas de gamme.

-s

Utilisez cette option pour basculer en mode syslog uniquement. Cela désactive le fichier journal standard et écrit les nouveaux périphériques dans le fichier journal système à la place. La valeur par défaut est désactivée.

NUMÉRISATION DE BASE

Il n'y a pas grand chose à dire sur celui-ci. Démarrez Bluelog avec les options appropriées, puis marchez/conduisez dans la zone et voyez ce que vous proposez.

Pour votre première analyse, essayez quelque chose de simple comme :

bluelog -vtn

Cela activera la sortie détaillée, les horodatages, les noms de périphérique et la sortie dans le fichier par défaut "devices.log". Il existe un certain nombre d'autres options que vous pouvez utiliser pour personnaliser le niveau de journalisation que Bluelog fera, mais la plupart des gens seront probablement satisfaits de l'heure, du MAC et du nom de l'appareil.

BLUELOG EN DIRECT

Bluelog Live est une interface alternative pour Bluelog. Au lieu de sortir les périphériques découverts sur la console ou de les écrire dans le fichier journal clairsemé, Bluelog créera une page Web avec les résultats que vous pourrez servir à quiconque souhaite regarder.

Pour plus d'informations sur Bluelog Live, veuillez consulter le fichier README.LIVE.

MODE DÉMON

L'exécution de Bluelog avec l'option -d le lancera en mode démon, ce qui le placera en arrière-plan. Ce mode est particulièrement utile lors de l'exécution de Bluelog Live.

Une seule instance de Bluelog peut s'exécuter à la fois, donc si vous essayez de démarrer Bluelog (en mode démon ou interactif) alors qu'il est déjà en cours d'exécution en mode démon, vous serez invité à arrêter le processus existant. Vous pouvez utiliser l'option -k pour tuer un processus Bluelog en cours d'exécution, ou simplement trouver le processus avec ps et le tuer manuellement.

Il convient de noter que l'activation du mode démon remplace également certaines autres options, telles que le mode verbeux (car il n'y a pas de sortie de terminal une fois que Bluelog passe en arrière-plan).

AUTEUR

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

DES DOSSIERS

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