gpsfake - En ligne dans le Cloud

PROGRAMME:

Nom

gpsfake - harnais de test pour gpsd, simulant un GPS

SYNOPSIS

faux gps [-1] [-h] [-b] [-c intervalle] [-identifiant niveau de débogage] [-l] [-m moniteur] [-g] [-n]
[-ou Options] [-p] [-P port] [-r initcmd] [-s vitesse] [-S] [-u] [-t] [-v]
[fichier journal...]

DESCRIPTION

gpsfake est un harnais de test pour gpsd et ses clients. Il ouvre un pty (pseudo-TTY), lance
une instance gpsd qui pense que le côté esclave du pty est son appareil GPS, et à plusieurs reprises
transmet le contenu d'un ou plusieurs fichiers journaux de test via le côté maître au GPS. Si
il y a plusieurs fichiers journaux, les phrases d'eux sont entrelacées dans l'ordre des fichiers
sont spécifiés.

gpsfake ne nécessite pas de privilèges root et peut être exécuté simultanément avec une production
instance gpsd sans causer de problèmes.

Les fichiers journaux peuvent contenir des paquets dans n'importe quel format pris en charge, y compris notamment NMEA,
SiRF, TSIP ou Zodiac. Les lignes de début commençant par # seront traitées comme des commentaires et
ignoré, sauf dans les cas particuliers suivants :

· un commentaire de la forme #Date : aaaa-mm-jj (format de date ISO8601) peut être utilisé pour définir le
date initiale du journal.

· un commentaire de la forme #Serial : [0-9]* [78][NOE][12] peut être utilisé pour définir le numéro de série
paramètres pour le journal - débit en bauds, longueur de mot, bits d'arrêt.

· un commentaire de la forme #Transport : UDP peut être utilisé pour falsifier une source UDP plutôt que le
pty normal.

L'instance gpsd est exécutée au premier plan. Le thread qui envoie de fausses données GPS au démon est
de fonctionner en arrière-plan.

OPTIONS

Avec l'option -1, le fichier journal est interprété une seule fois plutôt que plusieurs fois. Cette
L'option est destinée à faciliter les tests de régression.

Les -b active un indicateur de progression du bâton virevoltant sur l'erreur standard. A la résiliation, il
rapporte le temps écoulé.

Les -c définit le délai entre les phrases en secondes. Les valeurs fractionnaires des secondes sont
légal. La valeur par défaut est zéro (pas de délai).

Les -l fait en sorte que le programme vide une ligne ou un numéro de paquet juste avant que chaque phrase ne soit envoyée à
le démon. Si la phrase est textuelle (par exemple NMEA), le texte est également vidé. Si non,
le paquet sera vidé en hexadécimal (sauf pour les paquets RTCM, qui ne sont pas vidés à
tous). Cette option est utile pour vérifier que gpsfake obtient les limites de paquets correctes.

Les -i est pour le pas à pas dans les fichiers journaux. Il vide la ligne ou le numéro de paquet (et
la phrase si le protocole est textuel) suivi de " ? ". Uniquement lorsque les touches utilisateur Enter
est la ligne réellement transmise à gpsd.

Les -m spécifie un programme de surveillance dans lequel le démon doit être exécuté. Cette option est
destiné à être utilisé avec valgrind(1), gdb(1) et programmes similaires.

Les -g utilise la fonction de surveillance pour exécuter l'instance gpsd dans gpsfake sous le contrôle de
gdb.

Les -o spécifie les options à transmettre au démon. L'option -n passe -n pour démarrer le
démon lisant le GPS sans attendre un client (équivalent à -o "-n"). Les -D passes
une option -D au démon : ainsi -D 4 est un raccourci pour -o "-D 4".

L'option -p ("pipe") définit le mode observateur et vide les notifications NMEA et GPSD
généré par le journal vers la sortie standard. Ceci est utile pour les tests de régression.

L'option -P ("port") définit le port d'écoute du démon.

Les -r spécifie une commande d'initialisation à utiliser en mode pipe. La valeur par défaut est
?WATCH={"enable":true,"json":true}.

Les -s définit le débit en bauds pour le tty esclave. La valeur par défaut est 4800.

L'option -S indique à gpsfake d'insérer des délais réalistes dans l'entrée de test plutôt que
essayer de le faire passer par le démon aussi vite que possible. Cela fera exécuter le(s) test(s)
beaucoup plus lent, mais évite les défaillances floconneuses dues au filon de la machine et aux conditions de course possibles dans
la couche de pty.

Les -t force le framework de test à utiliser des périphériques TCP plutôt que pty. En plus d'être un test
de la gestion des sources TCP, cela peut être utile pour tester à partir des prisons chroot où
l'accès aux périphériques pty est verrouillé.

Les -u force le framework de test à utiliser des périphériques UDP plutôt que pty. En plus d'être un test
de la gestion des sources UDP, cela peut être utile pour les tests à partir des prisons chroot où
l'accès aux périphériques pty est verrouillé.

Les -v active les rapports d'avancement détaillés sur stderr. Il est principalement utile pour le débogage
gpsfake lui-même.

Les -x vide les paquets au fur et à mesure que gpsfake les rassemble. Il est principalement utile pour déboguer gpsfake
elle-même.

Les -h fait que gpsfake affiche un message d'utilisation et quitte.

L'argument doit être le nom d'un fichier contenant les données à cycler sur l'appareil.
gpsfake imprimera une notification à chaque cycle.

Normalement, gpsfake crée un pty pour chaque fichier journal et passe le côté esclave de l'appareil
au démon. Si le commentaire d'en-tête dans le fichier journal contient la chaîne "UDP", les paquets sont
à la place expédié via le port UDP 5000 à l'adresse 192.168.0.1.255. Vous pouvez les surveiller
avec ça: tcpdump -s0 -n -A -i lo udp ainsi que port 5000.

MAGIC COMMENTAIRES

Certains commentaires magiques dans les en-têtes de chargement de test peuvent modifier les conditions du test. Ces
sont:

Série:
Peut contenir un paramètre de port série tel que 4800 7N2 - débit en bauds suivi de 7 ou 8 pour
longueur d'octet, N ou O ou E pour la parité et 1 ou 2 pour les bits d'arrêt. Le test est exécuté avec
ces paramètres sur le port esclave que le démon voit.

Transport:
Les valeurs 'TCP' et 'UDP' forcent respectivement l'utilisation des flux TCP et UDP (la valeur par défaut est
un pty).

Retard-Cookie :
Doit être suivi de deux champs séparés par des espaces, d'un caractère délimiteur et d'un
délai numérique en secondes. Au lieu d'être divisé par des limites de paquets, le test
la charge est répartie sur les délimiteurs. Le retard est effectué après chaque alimentation. Peut être utile
pour imposer des limites d'écriture au milieu des paquets.

SUR MESURE ESSAIS

gpsfake est un wrapper trivial autour d'un module Python, également nommé gpsfake, qui peut être utilisé
aux sessions de script complètes impliquant une instance gpsd, un nombre quelconque de sessions client et tout
nombre de faux GPS alimentant l'instance du démon avec les données des journaux de phrases spécifiés.

La documentation source et intégrée pour ce module est livrée avec le développement gpsd
outils. Vous pouvez l'utiliser pour tester le gpsd lui-même ou n'importe quel client compatible gpsd
.

Les fichiers journaux à utiliser avec gpsfake peuvent être récupérés à l'aide de gpspipe, gpscat ou gpsmon à partir de
la distribution gpsd, ou toute autre application capable de créer un
sortie.

Si gpsfake se termine avec « Impossible d'exécuter gpsd : exécutable introuvable ». l'environnement
La variable GPSD_HOME peut être définie sur le chemin où se trouve gpsd. (au lieu d'ajouter que
dossier à la variable d'environnement PATH

Utiliser gpsfake en ligne en utilisant les services onworks.net