Patch gen

Fonction

Générer les patch (delta) entre chaque version publié afin que les joueurs ne récupère que la différence entre leur version et la version cible.

Options

patch_gen --help

Usage: patch_gen [-h][-v][-j<jobs>] <CommandLine...>
 
Generate patch
 
Where options are:
  -h or --help : Display this help
  -v or --version : Display version of this program
  -j <jobs> or --jobs <jobs> : Specifies the number of jobs (commands) to run simultaneously
  CommandLine : command line (For a list of valid commands and their paramaters try help)
Usage: patch_gen [-h][-v][-j<jobs>] <CommandLine...>

patch_gen help

INF 0942a740 patch_gen : Executing command : 'help commands'
INF 0942a740 patch_gen : Displaying commands and variables from category: commands
INF 0942a740 patch_gen :  0 createNewProduct: create a new package description file
INF 0942a740 patch_gen :  1 go             : perform a 'createNewProduct' if required and 'updateProduct' on patch_test/test0/test_package.xml
INF 0942a740 patch_gen :  2 updateProduct  : process a package

Command

createNewProduct

Création du nouveau package (squelette, configure le fichier xml)

updateProduct

Génération du package (génère les patchs / delta avec l'ancienne version)

go

Fonction de test

Usage

patch_gen createNewProduct patch_game/ryzom.xml
patch_gen updateProduct patch_game/ryzom.xml

Multi-thread

Info

Dans la commande 'updateProduct', nous avons la possibilité d'utiliser plusieurs thread pour effectuer les taches relativement longue.

Exemple : on lance ici 12 threads

patch_gen --jobs=12 updateProduct patch_game/ryzom.xml

Statistique

Réalisé sur une machine ayant 12 cpu.

Nombre de thread	Temps (s)	Temps
1	874	14 min 34
2	458	7 min 38
3	319	5 min 19
4	249	4 min 9
5	209	3 min 29
6	180	3 min 0
7	174	2 min 54
8	194	3 min 14
9	192	3 min 12
10	198	3 min 18
11	197	3 min 17
12	201	3 min 21

Sources

Localisation

Fichiers	Fonction
ryzom/tools/patch_gen/patch_gen_main.cpp	programme principal - récupère les arguments
ryzom/tools/patch_gen/patch_gen_main.h	entête du programme principal
ryzom/tools/patch_gen/patch_gen_common.cpp	réalise toutes les opérations
ryzom/tools/patch_gen/patch_gen_common.h	entête sur les opérations

Class

Nom de la class	fonction
CTaskPackageDescription	Exécution d'un thread (exécuté dans updateProduct / generatePatches)
CPackageDescription	Class principale, effectue toutes les opérations (sauf la partie generatePatches - il configure et lance les thread)