Discussion :

[ikuzar]

Bonjour,
J'ai un package de fichiers C. Il n ' y a pas de diagramme fourni avec. Je dois "deviner" les dépendances entre fichiers. Il y en a plein.
Ma question :
j'aimerais savoir s'il existe un outils permettant d'afficher les dépendances entre fichiers C de manière claire.
Merci d'avance.

[valefor]

De mémoire, l'outil de génération automatique de doc, Doxygen, génère un diagramme d'inclusion.

[ikuzar]

j'ai lancé doxygen mais il ne génère que la doc ( sur les fonctions / structures / membres ). Il ne génère pas de diagramme et pourtant j'ai bien installé graphviz ( apt-get install graphviz, je travaille sur Debian ).
Est ce que quelqu'un trouve une solution ? Est ce que quelqu'un connait l'extension d'un fichier généré par graphviz pour que je puisse faire une recherche.
Merci d'avance

[jabbounet]

Salut,

As-tu vérifié la configuration de doxygen, certaines options sont a positionner si tu veux qu'il te sorte le graphe. un petit coup d'oeil sur cette page peut t'aider

http://www.stack.nl/~dimitri/doxygen/diagrams.html

l'exemple donné sur cette page te génère par exemple:
http://www.stack.nl/~dimitri/doxygen...ams__e_8h.html
http://www.stack.nl/~dimitri/doxygen...ams__a_8h.html

[ikuzar]

La doc dit " Doxygen can use the "dot" tool from graphviz to generate more advanced diagrams and graphs" puis ...
"If you have the "dot" tool in the path, you can set HAVE_DOT to YES "

j'ai mis HAVE_DOT = YES

mais j'ai toujours pas les diagrammes dans le fichier html ...

[jabbounet]

La doc dit " Doxygen can use the "dot" tool from graphviz to generate more advanced diagrams and graphs" puis ...
"If you have the "dot" tool in the path, you can set HAVE_DOT to YES "

j'ai mis HAVE_DOT = YES

mais j'ai toujours pas les diagrammes dans le fichier html ...

Cette condition est-elle remplie?

If you have the "dot" tool in the path

chez moi j'ai (dans un terminal ou je fais des compilations impliquant doxygen et des graphes):

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
$which dot
/usr/local/bin/dot
$echo $PATH
....:/usr/local/bin:.....
 
$dot -v
dot - graphviz version 2.24.0 (20090616.2323)
Activated plugin library: libgvplugin_pango.so.6
Using textlayout: textlayout:cairo
Activated plugin library: libgvplugin_dot_layout.so.6
Using layout: dot:dot_layout
Activated plugin library: libgvplugin_core.so.6
Using render: dot:core
Using device: dot:dot:core
The plugin configuration file:
        /usr/local/lib/graphviz/config6
                was successfully loaded.
    render      :  cairo dot fig gd map ps svg tk vml vrml xdot
    layout      :  circo dot fdp neato nop nop1 nop2 osage patchwork twopi
    textlayout  :  textlayout
    device      :  bmp canon cmap cmapx cmapx_np dot eps fig gd gd2 gif gtk gv ico imap imap_np ismap jpe jpeg jpg pdf plain plain-ext png ps ps2 svg svgz tif tiff tk vml vmlz vrml wbmp x11 xdot xlib
    loadimage   :  (lib) eps gd gd2 gif jpe jpeg jpg png ps svg xbm

[ikuzar]

If you have the "dot" tool in the path
Quand je fais which dot, j'obtient :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
moi-debian:/opt/doxygen-1.7.1# which dot
/usr/bin/dot

en fait j'ai pas compris ce passage. Je sais juste que /usr/bin/dot existe ...
De quel path parle - t - on ici ? est ce que c'est bien comme ceci que ca marche : graphviz cherche dot dans $PATH ?

sinon quand je fais echo $PATH, j'obtient :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
aro-debian:/opt/doxygen-1.7.1# echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

[jabbounet]

If you have the "dot" tool in the path
Quand je fais which dot, j'obtient :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
moi-debian:/opt/doxygen-1.7.1# which dot
/usr/bin/dot

en fait j'ai pas compris ce passage. Je sais juste que /usr/bin/dot existe ...
De quel path parle - t - on ici ? est ce que c'est bien comme ceci que ca marche : graphviz cherche dot dans $PATH ?

sinon quand je fais echo $PATH, j'obtient :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
aro-debian:/opt/doxygen-1.7.1# echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

Ok dot existe est est dans le PATH.
et dot -v te donne quelque chose d'équivalent a ce que j'ai montré?

Autrement ces option sont elles positionés?

# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT
# tags are set to YES then doxygen will generate a graph for each documented
# file showing the direct and indirect include dependencies of the file with
# other documented files.

INCLUDE_GRAPH = YES

# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and
# HAVE_DOT tags are set to YES then doxygen will generate a graph for each
# documented header file showing the documented files that directly or
# indirectly include this file.

INCLUDED_BY_GRAPH = YES

[ikuzar]

J'ai bien :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT
# tags are set to YES then doxygen will generate a graph for each documented
# file showing the direct and indirect include dependencies of the file with
# other documented files.
 
INCLUDE_GRAPH          = YES
 
# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and
# HAVE_DOT tags are set to YES then doxygen will generate a graph for each
# documented header file showing the documented files that directly or
# indirectly include this file.
 
INCLUDED_BY_GRAPH      = YES

et puis dot -v me donne :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
aro-debian:/home/aro/Desktop/ossim_sourceforge/ossim-2.1# dot -v
Activated plugin library: libgvplugin_pango.so.5
Using textlayout: textlayout:cairo
Activated plugin library: libgvplugin_dot_layout.so.5
Using layout: dot:dot_layout
Activated plugin library: libgvplugin_core.so.5
Using render: dot:core
Using device: dot:dot:core
The plugin configuration file:
	/usr/lib/graphviz/config4
		was successfully loaded.
    render	:  cairo dot fig gd map ps svg tk vml vrml xdot
    layout	:  circo dot fdp neato nop nop1 nop2 twopi
    textlayout	:  textlayout
    device	:  canon cmap cmapx cmapx_np dia dot eps fig gd gd2 gif hpgl imap imap_np ismap jpe jpeg jpg mif mp pcl pdf pic plain plain-ext png ps ps2 svg svgz tk vml vmlz vrml vtx wbmp xdot xlib
    loadimage	:  (lib) gd gd2 gif jpe jpeg jpg png ps svg

Donc les param dont on parle ici sont bien positionnés apparemment.

[jabbounet]

Ok, et ENABLE_PREPROCESSING, SEARCH_INCLUDES sont bien a YES?

Après ça je suis sec.

[ikuzar]

Oui ils sont à YES :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will
# evaluate all C-preprocessor directives found in the sources and include
# files.
 
ENABLE_PREPROCESSING   = YES

.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
# in the INCLUDE_PATH (see below) will be search if a #include is found.
 
SEARCH_INCLUDES        = YES

[jabbounet]

Je suis sec. la doc est bien régénéré quand tu relance l'outil?


Autrement, Si c'est juste pour analyser les dépendances, j'ai déjà essayé cet outils pour analyser du code, mais il a ses limites.
http://sourcenav.sourceforge.net/

et je suis tombé la dessus en le recherchant (cela peut t'intéresser)
http://www.flourish.org/cinclude2dot/

[ikuzar]

Oui, les docs sont bien générées. Il affiche le nom des structures, les champs en format html et y a un ptit commentaire aussi je crois.

[jabbounet]

ok, Le seul truc que je vois c'est que tu n'es peu être pas sur les bonnes pages.

chez moi, pour accéder aux graphe d'inclusion je dois aller sur la page spécifiques des .h, a partir de l'onglet Files. Ce ne sont pas les mêmes pages que pour les classes/structures.

[valefor]

Tu as essayé de configurer doxygen avec le wizard, en mode avancé... Peut-être qu'en parcourant les options tu verras quelque chose qui te saute aux yeux ?

[ikuzar]

Pour info : j'ai installé un fichier executable doxygene.bin, j'ai pas compilé la source. Si le problème ne vient pas de là, je pense que c'est toujours au niveau de la config et quand j'aurais le temps j'installerais doxywizard ptèt pour y voir plus clair

ok, Le seul truc que je vois c'est que tu n'es peu être pas sur les bonnes pages.

chez moi, pour accéder aux graphe d'inclusion je dois aller sur la page spécifiques des .h, a partir de l'onglet Files. Ce ne sont pas les mêmes pages que pour les classes/structures.

Qu'est ce que tu veux dire par page spécifique des .h ? je susi allé dans l'onglet Files mais rien du tout. De toute facon quand je fais un find . *diagr*.* il ne trouve pas de diagramme du tout. Alors que s'il y avait vraiment au moins un fichier du genre "diagrams_d.h" il l'aurait affiché...

Tu as essayé de configurer doxygen avec le wizard, en mode avancé... Peut-être qu'en parcourant les options tu verras quelque chose qui te saute aux yeux ?

Non , j'ai pas essayé de configurer doxygen avec doxywizard, car je voulais limiter les problèmes de config !

[jabbounet]

Chez moi les images générés sont au format png.

As-tu des fichier *.png ou autre qui sont générés?

chez moi j'ai cette configuration par rapport a dot.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
 
#---------------------------------------------------------------------------
# Configuration options related to the dot tool   
#---------------------------------------------------------------------------
 
# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 
# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base 
# or super classes. Setting the tag to NO turns the diagrams off. Note that 
# this option is superseded by the HAVE_DOT option below. This is only a 
# fallback. It is recommended to install and use dot, since it yields more 
# powerful graphs.
 
CLASS_DIAGRAMS         = YES
 
# If set to YES, the inheritance and collaboration graphs will hide 
# inheritance and usage relations if the target is undocumented 
# or is not a class.
 
HIDE_UNDOC_RELATIONS   = NO
 
# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 
# available from the path. This tool is part of Graphviz, a graph visualization 
# toolkit from AT&T and Lucent Bell Labs. The other options in this section 
# have no effect if this option is set to NO (the default)
 
HAVE_DOT               = YES
 
# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 
# will generate a graph for each documented class showing the direct and 
# indirect inheritance relations. Setting this tag to YES will force the 
# the CLASS_DIAGRAMS tag to NO.
 
CLASS_GRAPH            = YES
 
# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 
# will generate a graph for each documented class showing the direct and 
# indirect implementation dependencies (inheritance, containment, and 
# class references variables) of the class with other documented classes.
 
COLLABORATION_GRAPH    = YES
 
# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen 
# will generate a graph for groups, showing the direct groups dependencies
 
GROUP_GRAPHS           = YES
 
# If the UML_LOOK tag is set to YES doxygen will generate inheritance and 
# collaboration diagrams in a style similar to the OMG's Unified Modeling 
# Language.
 
UML_LOOK               = YES
 
# If set to YES, the inheritance and collaboration graphs will show the 
# relations between templates and their instances.
 
TEMPLATE_RELATIONS     = YES
 
# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 
# tags are set to YES then doxygen will generate a graph for each documented 
# file showing the direct and indirect include dependencies of the file with 
# other documented files.
 
INCLUDE_GRAPH          = YES
 
# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 
# HAVE_DOT tags are set to YES then doxygen will generate a graph for each 
# documented header file showing the documented files that directly or 
# indirectly include this file.
 
INCLUDED_BY_GRAPH      = YES
 
# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will 
# generate a call dependency graph for every global function or class method. 
# Note that enabling this option will significantly increase the time of a run. 
# So in most cases it will be better to enable call graphs for selected 
# functions only using the \callgraph command.
 
CALL_GRAPH             = YES
 
# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 
# will graphical hierarchy of all classes instead of a textual one.
 
GRAPHICAL_HIERARCHY    = YES
 
# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES 
# then doxygen will show the dependencies a directory has on other directories 
# in a graphical way. The dependency relations are determined by the #include
# relations between the files in the directories.
 
DIRECTORY_GRAPH        = YES
 
# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images 
# generated by dot. Possible values are png, jpg, or gif
# If left blank png will be used.
 
DOT_IMAGE_FORMAT       = png
 
# The tag DOT_PATH can be used to specify the path where the dot tool can be 
# found. If left blank, it is assumed the dot tool can be found in the path.
 
DOT_PATH               = 
 
# The DOTFILE_DIRS tag can be used to specify one or more directories that 
# contain dot files that are included in the documentation (see the 
# \dotfile command).
 
DOTFILE_DIRS           = 
 
# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width 
# (in pixels) of the graphs generated by dot. If a graph becomes larger than 
# this value, doxygen will try to truncate the graph, so that it fits within 
# the specified constraint. Beware that most browsers cannot cope with very 
# large images.
 
MAX_DOT_GRAPH_WIDTH    = 1024
 
# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height 
# (in pixels) of the graphs generated by dot. If a graph becomes larger than 
# this value, doxygen will try to truncate the graph, so that it fits within 
# the specified constraint. Beware that most browsers cannot cope with very 
# large images.
 
MAX_DOT_GRAPH_HEIGHT   = 1024
 
# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the 
# graphs generated by dot. A depth value of 3 means that only nodes reachable 
# from the root by following a path via at most 3 edges will be shown. Nodes 
# that lay further from the root node will be omitted. Note that setting this 
# option to 1 or 2 may greatly reduce the computation time needed for large 
# code bases. Also note that a graph may be further truncated if the graph's 
# image dimensions are not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH 
# and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the depth value (the default), 
# the graph is not depth-constrained.
 
MAX_DOT_GRAPH_DEPTH    = 0
 
# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent 
# background. This is disabled by default, which results in a white background. 
# Warning: Depending on the platform used, enabling this option may lead to 
# badly anti-aliased labels on the edges of a graph (i.e. they become hard to 
# read).
 
DOT_TRANSPARENT        = NO
 
# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output 
# files in one run (i.e. multiple -o and -T options on the command line). This 
# makes dot run faster, but since only newer versions of dot (>1.8.10) 
# support this, this feature is disabled by default.
 
DOT_MULTI_TARGETS      = NO
 
# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 
# generate a legend page explaining the meaning of the various boxes and 
# arrows in the dot generated graphs.
 
GENERATE_LEGEND        = YES
 
# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 
# remove the intermediate dot files that are used to generate 
# the various graphs.
 
DOT_CLEANUP            = YES

Autrement quand tu compile, vois tu le processus dot travailler pendant la génération de la documentation?

Sous linux quand je fais un top je le vois de temps en temps.