Easy TSP (was Re: [Tsp-devel] TSP Facile)

[Frederik Deweerdt]

Translation follows:

Hi,

As I'm frequently asked about it, here's a short summary "TSP for dummies"
style, or poetically put "How to master the five headed dragon".
By following the coming links, you should be able to fit TSP in any data
producer in one or two sweating days.

1) Download TSP souces
http://download.savannah.nongnu.org/releases/tsp/
Using the latest realease is a good idea, nowadays it's 0.8.3
http://download.savannah.nongnu.org/releases/tsp/tsp-0.8.x/tsp-0.8.3/sources/

2) RTFM[1]
Sadly, the programmer manual need to be read. But not too much tough, as
the true hacker despises documentation in any form, giving him the
ability to rant on the code itself.
http://download.savannah.nongnu.org/releases/tsp/documentations/tsp_programming_tutorial-1.0.pdf

3) Build the TSP lib
Chapter 2.3.2 of the above document explains this step nicely. CMake
http://www.cmake.org should've been installed previously. A little
tweaking could be needed for dynamic libraries or for Windows, but
otherwise this should be straightforward.

4) Add TSP to your data provider
Chapter 4 is also very instructing. Thanks to the great gurus that made
their knowledge available in a written form.
As an added bonus, I'll add the sample "stub" TSP provider and its
simple main, that keeps being helpful.

5) Test your application
We reach the TSPian climax!
- Either with the TARGA gui (thanks to the masked contributor)
  http://www.ts2p.org/tsp/API_doc/html/group__TSP__Targa.html
- Or with the command line (for real nerds)
  http://www.ts2p.org/tsp/API_doc/html/group__TSP__Stdout.html
- Or in a truly-meta-generical way as explained in the following
  document, page 9.
  
http://download.savannah.nongnu.org/releases/tsp/events/First_TSP_Workshop_27march2007/TSP_SDK.pdf
We can easily determine if the provider is working, or if we need to run
gdb to examine that core dump file :=)

That's it, thanks for reading this, and for sharing the TSP'erience with us.
Yves

[1] In english in the text :-)

On Fri, Mar 07, 2008 at 11:10:42AM +0100, DUFRENNE, Yves wrote:
> 
> 
> Salut,
>  
> Comme on me le demande souvent, voici un petit résumé sur "le TSP facile pour 
> les nuls en 5 étapes", ou en plus poétique "Comment dompter les 5 têtes du 
> dragon"
> En suivant ces liens, vous devriez pouvoir intégrer TSP dans n'importe quel 
> producteur de données en 1 jour ou 2 de bonne transpiration sur le clavier.
>  
> 1) Télécharger les sources de TSP
> http://download.savannah.nongnu.org/releases/tsp/
> Pour commencer, les dernières sources labélisées sont un bon départ, donc 
> actuellement c'est la 0.8.3.
> http://download.savannah.nongnu.org/releases/tsp/tsp-0.8.x/tsp-0.8.3/sources/
>  
> 2) RTFM
> Et oui, il faut bien lire la doc du programmeur, mais pas trop car un vrai 
> hacker méprise toute forme de documentation pour mieux pouvoir râler sur le 
> code.
> http://download.savannah.nongnu.org/releases/tsp/documentations/tsp_programming_tutorial-1.0.pdf
>  
> 3) Générer sa lib TSP
> Pour cela le chapitre 2.3.2 du doc précédent est vraiment bien fait. Il 
> suppose que vous ayez Cmake installé, et peut nécessiter un peu de travail 
> pour des avoir des librairies dynamiques ou pour marcher sous Windows, mais 
> sinon c'est direct.
>  
> 4) Intégrer TSP dans son Provider.
> Le chapitre 4 est aussi très éclairant, merci aux grands manitous qui ont mis 
> par écrit leurs immenses savoirs.
> Je rajoute en fichier bonus le petit exemple de provider "stub" de TSP avec 
> son petit main, qui continue à faire école.
>  
> 5) Tester le résultat 
> Là c'est l'apogée TSPiennes !
> - que ce soit en graphique avec TARGA (Merci au contributeur masqué) 
> http://www.ts2p.org/tsp/API_doc/html/group__TSP__Targa.html
> - ou en commande en ligne (pour les vrais nerds) 
> http://www.ts2p.org/tsp/API_doc/html/group__TSP__Stdout.html
> - ou en total méta générique (page 9 du lien suivant) 
> http://download.savannah.nongnu.org/releases/tsp/events/First_TSP_Workshop_27march2007/TSP_SDK.pdf
> On peut facilement tester si son provider marche, ou si il faut lancer gdb 
> pour traquer son "core dump" :=)
>  
> Voila, merci de m'avoir lu, et encore + de vivre avec nous la TSP'erience.
> Yves
>  
> ------------------------------------------- 
> Yves DUFRENNE 
> Specialist in Linux Security 
> 31 Rue des Cosmonautes, 31400 Toulouse, France 
> Tel.: +33-5-6219 7150, Fax: +33-5-6219 7741 
> ------------------------------------------- 
> P Before printing, think about ENVIRONMENTAL responsibility 
>  
> 
> 
> Ce courriel (incluant ses eventuelles pieces jointes) peut contenir des 
> informations confidentielles et/ou protegees ou dont la diffusion est 
> restreinte. Si vous avez recu ce courriel par erreur, vous ne devez ni le 
> copier, ni l'utiliser, ni en divulguer le contenu a quiconque. Merci d'en 
> avertir immediatement l'expediteur et d'effacer ce courriel de votre systeme. 
> Astrium decline toute responsabilite en cas de corruption par virus, 
> d'alteration ou de falsification de ce courriel lors de sa transmission par 
> voie electronique.
> 
> This email (including any attachments) may contain confidential and/or 
> privileged information or information otherwise protected from disclosure. If 
> you are not the intended recipient, please notify the sender immediately, do 
> not copy this message or any attachments and do not use it for any purpose or 
> disclose its content to any person, but delete this message and any 
> attachments from your system. Astrium disclaims any and all liability if this 
> email transmission was virus corrupted, altered or falsified.
> ---------------------------------------------------------------------
> Astrium SAS (393 341 516 RCS Paris) - Siege social: 6 rue Laurent Pichat, 
> 75016 Paris, France


> _______________________________________________
> Tsp-devel mailing list
> address@hidden
> http://lists.nongnu.org/mailman/listinfo/tsp-devel