~mfisch/ubuntu/precise/live-manual/live-manual-fix-ftbfs-831392
» Revision
1.1.26
: manual/fr/project_bugs.ssi
« back to all changes in this revision
Viewing changes to manual/fr/project_bugs.ssi
- browse files at revision 1.1.26
- compare with another revision
- compare with revision 1.1.26
- download diff
- download tarball
- view history from revision 1.1.26
- Committer: Package Import Robot
- Author(s): Daniel Baumann
- Date: 2011-09-30 14:53:41 UTC
- mto: This revision was merged to the branch mainline in revision 28.
- Revision ID: package-import@ubuntu.com-20110930145341-9km1b3ip4mhuhtzh
Tags: upstream-3.0~a8
Import upstream version 3.0~a8
- files modified:
- VERSION
added
removed
manual/fr/project_bugs.ssi
1
B~ Reporting bugs
2
3
1~bugs Reporting bugs
4
5
Debian Live is far from being perfect, but we want to make it as close as
6
possible to perfect - with your help. Do not hesitate to report a bug: it is
7
better to fill a report twice than never. However, this chapter includes
8
recommendations how to file good bug reports.
9
10
For the impatient:
11
12
_* Always check first the image status updates on our homepage at
13
http://live.debian.net/ for known issues.
14
15
_* Always try to reproduce the bug with the *{most recent versions}* of
16
live-build, live-boot, and live-config before submitting a bug report.
17
18
_* Try to give *{as specific information as possible}* about the bug. This
19
includes (at least) the version of live-build, live-boot, and live-config
20
used and the distribution of the live system you are building.
21
22
2~ Known issues
23
24
Because Debian *{testing}* and Debian *{unstable}* distributions are a
25
moving target, when you specify either as the target system distribution, a
26
successful build may not always be possible.
1
B~ Rapporter des bogues
2
3
1~bugs Rapporter des bogues
4
5
Debian Live est loin d'être parfait, mais nous voulons le rendre aussi
6
proche que possible de parfait - avec votre aide. N'hésitez pas à signaler
7
un bogue: il est préférable de remplir un rapport deux fois plus que
8
jamais. Toutefois, ce chapitre contient des recommandations pour déposer les
9
rapports de bogues.
10
11
Pour les impatients:
12
13
_* Commencez toujours par vérifier les mises à jour de la situation de
14
l'image sur notre page d'accueil http://live.debian.net/ pour voir les
15
problèmes connus.
16
17
_* Toujours essayer de reproduire le bogue avec *{les versions les plus
18
récents}* de live-build, live-boot, et live-config avant de présenter un
19
rapport de bogue.
20
21
_* Essayez de donner des informations aussi précises que possible sur le
22
bogue. Cela comprend (au moins) la version de live-build, live-boot et
23
live-config, de la distribution utilisée et du système live que vous
24
construisez.
25
26
2~ Problèmes connus
27
28
Parce que les distributions Debian *{testing}* et Debian *{unstable}* sont
29
une cible mouvante, quand vous les spécifiez comme la distribution du
30
système cible, une construction avec succès n'est pas toujours possible.
27
31
28
32
% FIXME:
29
33
30
If this causes too much difficulty for you, do not build a system based on
31
*{testing}* or *{unstable}*, but rather, use *{stable}*. live-build does
32
always default to the *{stable}* release.
33
34
Currently known issues are listed under the section 'status' on our homepage
35
at http://live.debian.net/.
36
37
It is out of the scope of this manual to train you to correctly identify and
38
fix problems in packages of the development distributions, however, there
39
are two things you can always try: If a build fails when the target
40
distribution is *{testing}*, try *{unstable}*. If *{unstable}* does not work
41
either, revert to *{testing}* and pin the newer version of the failing
42
package from *{unstable}* (see {APT pinning}#apt-pinning for details).
43
44
2~ Rebuild from scratch
45
46
To ensure that a particular bug is not caused by an uncleanly built system,
47
please always rebuild the whole live system from scratch to see if the bug
48
is reproducible.
49
50
2~ Use up-to-date packages
51
52
Using outdated packages can cause significant problems when trying to
53
reproduce (and ultimately fix) your problem. Make sure your build system is
54
up-to-date and any packages included in your image are up-to-date as well.
55
56
2~collect-information Collect information
57
58
Please provide enough information with your report. At least include the
59
exact version of live-build version where the bug is encountered and steps
60
to reproduce it. Please use common sense and include other relevant
61
information if you think that it might help in solving the problem.
62
63
To make the most out of your bug report, we require at least the following
64
information:
65
66
_* Architecture of the host system
67
68
_* Version of live-build on the host system
69
70
_* Version of live-boot on the live system
71
72
_* Version of live-config on the live system
73
74
_* Version of #{debootstrap}# and/or #{cdebootstrap}# on the host system
75
76
_* Architecture of the live system
77
78
_* Distribution of the live system
79
80
_* Version of the kernel on the live system
81
82
You can generate a log of the build process by using the #{tee}# command. We
83
recommend doing this automatically with an #{auto/build}# script; (see
84
{Managing a configuration}#managing-a-configuration for details).
34
Si cela provoque trop de difficulté pour vous, ne pas construire un système
35
basé sur *{testing}* or *{unstable}*, mais plutôt utiliser
36
*{stable}*. live-build fait toujours défaut à la version *{stable}*.
37
38
Les problèmes connus sont énumérés sous la section "status" sur notre page à
39
http://live.debian.net/.
40
41
Il est hors cadre de ce manuel vous former correctement à identifier et
42
corriger les problèmes dans les paquets des distributions de développement,
43
cependant, il y a deux choses que vous pouvez toujours essayer: Si une
44
construction échoue lorsque la distribution cible est *{testing}*, essayez
45
*{unstable}*. Si *{unstable}* ne fonctionne pas non plus, revenir à
46
*{testing}* et fixer la nouvelle version du paquet qui échoue à partir de
47
*{unstable}* (voir {APT pinning}#apt-pinning pour plus de détails).
48
49
2~ Reconstruire à partir de zéro
50
51
Afin de s'assurer que un bogue en particulier n'est pas causé par un système
52
construit malpropre, s'il vous plaît toujours reconstruire l'ensemble du
53
système live à partir de zéro pour voir si le bogue est reproductible.
54
55
2~ Utilisez paquets mises à jour
56
57
L'utilisation de paquets obsolètes peut causer d'importants problèmes en
58
essayant de reproduire (et finalement régler) votre problème. Assurez-vous
59
que votre système de construction est mis à jour et tous les paquets inclus
60
dans votre image sont mises à jour aussi.
61
62
2~collect-information Recueillir l'information
63
64
S'il vous plaît fournir assez d'informations à votre rapport. Inclure au
65
moins la version exacte de live-build où le bogue est rencontré et les
66
mesures pour le reproduire. S'il vous plaît utilisez votre bon sens et
67
inclure d'autres renseignements pertinents, si vous pensez que cela pourrait
68
aider à résoudre le problème.
69
70
Pour tirer le meilleur parti de votre rapport de bogue, nous avons besoin
71
d'au moins les informations suivantes:
72
73
_* L'architecture du système hôte
74
75
_* Version de live-build sur le système hôte
76
77
_* Version de live-boot sur le système live
78
79
_* Version de live-config sur le système live
80
81
_* Version de #{debootstrap}# et/ou #{cdebootstrap}# sur le système hôte
82
83
_* L'architecture du système live
84
85
_* Répartition du système live
86
87
_* Version du noyau sur le système live
88
89
Vous pouvez générer un journal du processus de construction en utilisant la
90
commande #{tee}#. Nous recommandons de faire cela automatiquement avec un
91
script #{auto/build}#; (voir {Gestion d'une
92
configuration}#managing-a-configuration pour les détails).
85
93
86
94
code{
87
95
89
97
90
98
}code
91
99
92
At boot time, live-boot stores a log in #{/var/log/live.log}# (or
100
Au démarrage, live-boot stocke un journal dans #{/var/log/live.log}# (ou
93
101
#{/var/log/live-boot.log}#).
94
102
95
Additionally, to rule out other errors, it is always a good idea to tar up
96
your #{config/}# directory and upload it somewhere (do *{not}* send it as an
97
attachment to the mailing list), so that we can try to reproduce the errors
98
you encountered. If this is difficult (e.g. due to size) you can use the
99
output of #{lb config --dump}# which produces a summary of your config tree
100
(i.e. lists files in subdirectories of #{config/}# but does not include
101
them).
102
103
Remember to send in any logs that were produced with English locale
104
settings, e.g. run your live-build commands with a leading #{LC_ALL=C}# or
105
#{LC_ALL=en_US}#.
106
107
2~ Isolate the failing case if possible
108
109
If possible, isolate the failing case to the smallest possible change that
110
breaks. It is not always easy to do this, so if you can't manage it for your
111
report, don't worry. However, if you plan your development cycle well, using
112
small enough change sets per iteration, you may be able to isolate the
113
problem by constructing a simpler 'base' configuration that closely matches
114
your actual configuration plus just the broken change set added to it. If
115
you have a hard time sorting out which of your changes broke, it may be that
116
you are including too much in each change set and should develop in smaller
117
increments.
118
119
2~ Use the correct package to report the bug against
120
121
Where does the bug appear?
122
123
3~ At build time whilst bootstrapping
124
125
live-build first bootstraps a basic Debian system with #{debootstrap}# or
126
#{cdebootstrap}#. Depending on the bootstrapping tool used and the Debian
127
distribution it is bootstrapping, it may fail. If a bug appears here, check
128
if the error is related to a specific Debian package (most likely), or if it
129
is related to bootstrapping tool itself.
130
131
In both cases, this is not a bug in Debian Live, but rather in Debian itself
132
which we can not fix this directly. Please report such a bug against the
133
bootstrapping tool or the failing package.
134
135
3~ At build time whilst installing packages
136
137
live-build installs additional packages from the Debian archive and
138
depending on the Debian distribution used and the daily archive state, it
139
can fail. If a bug appears here, check if the error is also reproducible on
140
a normal system.
141
142
If this is the case, this is not a bug in Debian Live, but rather in Debian
143
- please report it against the failing package. Running #{debootstrap}#
144
separately from the Live system build or running #{lb bootstrap --debug}#
145
will give you more information.
146
147
Also, if you are using a local mirror and/or any of sort of proxy and you
148
are experiencing a problem, please always reproduce it first by
149
bootstrapping from an official mirror.
150
151
3~ At boot time
152
153
If your image does not boot, please report it to the mailing list together
154
with the information requested in {Collect
155
information}#collect-information. Do not forget to mention, how/when the
156
image failed, in Qemu, Virtualbox, VMWare or real hardware. If you are using
157
a virtualization technology of any kind, please always run it on real
158
hardware before reporting a bug. Providing a screenshot of the failure is
159
also very helpful.
160
161
3~ At run time
162
163
If a package was successfully installed, but fails while actually running
164
the Live system, this is probably a bug in Debian Live. However,
165
166
2~ Do the research
167
168
Before filing the bug, please search the web for the particular error
169
message or symptom you are getting. As it is highly unlikely that you are
170
the only person experiencing a particular problem, there is always a chance
171
that it has been discussed elsewhere, and a possible solution, patch, or
172
workaround has been proposed.
173
174
You should pay particular attention to the Debian Live mailing list, as well
175
as the homepage, as these are likely to contain the most up-to-date
176
information. If such information exists, always include the references to it
177
in your bug report.
178
179
In addition, you should check the current bug lists for live-build,
180
live-boot, and live-config to see whether something similar has been
181
reported already.
182
183
2~ Where to report bugs
184
185
The Debian Live project keeps track of all bugs in the Debian Bug Tracking
186
System (BTS). For information on how to use the system, please see
187
http://bugs.debian.org/. You can also submit the bugs by using the
188
#{reportbug}# command from the package with the same name.
189
190
In general, you should report build time errors against the live-build
191
package, boot time errors against live-boot, and run time errors against
192
live-config. If you are unsure of which package is appropriate or need more
193
help before submitting a bug report, please send a message to the mailing
194
list and we will help you to figure it out.
195
196
Please note that bugs found in distributions derived from Debian (such as
197
Ubuntu and others) should *{not}* be reported to the Debian BTS unless they
198
can be also reproduced on a Debian system using official Debian packages.
103
Par ailleurs, pour écarter d'autres erreurs, c'est toujours une bonne idée
104
faire un tar de votre répertoire #{config/}# et de le télécharger quelque
105
part (*{ne pas}* l'envoyer en pièce jointe à la liste de diffusion), de
106
sorte que nous pouvons essayer de reproduire les erreurs que vous
107
rencontrez. Si cela est difficile (en raison par exemple de la taille) vous
108
pouvez utiliser la sortie de #{lb config --dump}# qui produit un résumé de
109
votre arbre de config (c'est-à-dire les listes des fichiers dans les
110
sous-répertoires de #{config/}# mais ne les inclut pas).
111
112
N'oubliez pas d'envoyer tous les journaux qui ont été produites avec le
113
paramètre régionaux anglais, par exemple exécuter vos commandes live-build
114
précédées par #{LC_ALL=C}# ou #{LC_ALL=en_US}#.
115
116
2~ Isoler le cas qui échoue, si possible
117
118
Si possible, isoler le cas qui échoue au plus petit changement possible. Il
119
n'est pas toujours facile de faire cela, donc si vous ne pouvez pas le gérer
120
pour votre rapport, ne vous inquiétez pas. Toutefois, si vous planifiez
121
votre cycle de développement bien, en utilisant petits ensembles de changes
122
par itération, vous pourriez être capable d'isoler le problème en
123
construisant une configuration simple «base» qui correspond étroitement à la
124
configuration réelle avec seulement le changement cassé ajouté. Si il est
125
difficile de trier vos modifications que cassent, il est possible que vous y
126
compris trop dans chaque ensemble de modifications et devraient se
127
développer en petits incréments.
128
129
2~ Utilisez le paquet adéquat pour rapporter le bogue
130
131
Où est-ce que le bogue apparaît?
132
133
3~ Au moment de la construction tandis l'amorçage
134
135
live-build amorce (bootstrap) d'abord un système Debian de base avec
136
#{debootstrap}# ou #{cdebootstrap}#. Selon l'outil d'amorçage utilisé et de
137
la distribution Debian il peut échouer. Si un bogue apparaît ici, vérifiez
138
si l'erreur est liée à un paquet Debian spécifique (plus probable), ou si il
139
est lié à l'outil d'amorçage lui-même.
140
141
Dans les deux cas, ce n'est pas un bogue dans Debian Live, mais plutôt dans
142
Debian lui-même que nous ne pouvons résoudre directement. S'il vous plaît
143
rapportez un bogue sur l'outil d'amorçage ou du paquet défaillant.
144
145
3~ Au moment de la construction tandis l'installation de paquets
146
147
live-build installe des paquets supplémentaires de l'archive Debian et en
148
fonction de la distribution Debian utilisée et l'état quotidienne de
149
l'archive, il peut échouer. Si un bogue apparaît ici, vérifiez si l'erreur
150
est également reproductible sur un système normal.
151
152
Si c'est le cas, ce n'est pas un bogue dans Debian Live, mais plutôt dans
153
Debian - s'il vous plaît faire le rapport sur le paquet
154
défaillant. L'exécution de #{debootstrap}# séparément du système de
155
construction ou l'exécution de #{lb bootstrap --debug}# vous donnera plus
156
d'informations.
157
158
Aussi, si vous utilisez un miroir local et/ou un proxy et vous rencontrez un
159
problème, s'il vous plaît toujours le reproduire d'abord en amorçant depuis
160
un miroir officiel.
161
162
3~ Au moment du démarrage
163
164
Si votre image ne démarre pas, s'il vous plaît le signaler à la liste de
165
diffusion avec les informations demandées dans {Recueillir
166
l'information}#collect-information. Ne pas oublier de mentionner,
167
comment/quand l'image a échoué, dans Qemu, VirtualBox, VMWare ou matériel
168
réel. Si vous utilisez une technologie de virtualisation d'aucune sorte,
169
s'il vous plaît toujours tester sur matériel réel avant de rapporter un
170
bug. Fournir une copie d'écran de l'échec est également très utile.
171
172
3~ Au moment de l'exécution
173
174
Si un paquet a été installé avec succès, mais échoue tout en exécutant le
175
système Live, c'est probablement un bogue dans Debian Live. Cependant,
176
177
2~ Faire les recherches
178
179
Avant de présenter le bogue, s'il vous plaît recherchez sur le web pour le
180
message d'erreur ou un symptôme particulier que vous obtenez. Comme il est
181
hautement improbable que vous êtes la seule personne qui expérience un
182
problème particulier, il ya toujours une chance qu'il a été discuté
183
ailleurs, et une solution possible, un correctif, ou une solution de
184
contournement a été proposé.
185
186
Vous devez prêter une attention particulière à la liste de diffusion de
187
Debian Live, ainsi que à la page d'accueil, car elles sont susceptibles de
188
contenir des informations à jour. Si ces informations existent, toujours
189
inclure les références au sein de vos rapport de bogues.
190
191
En outre, vous devriez vérifier les listes de bogues en cours de live-build,
192
live-boot, et live-config pour voir si quelque chose de semblable n'a été
193
déjà signalé.
194
195
2~ Où rapporter les bogues
196
197
Le projet Debian Live conserve la trace de tous les bogues dans le système
198
Debian Bug Tracking System (BTS). Pour plus d'informations sur la façon
199
d'utiliser le système, s'il vous plaît voir http://bugs.debian.org/. Vous
200
pouvez également soumettre les bogues en utilisant la commande #{reportbug}#
201
à partir du paquet du même nom.
202
203
En général, vous devez signaler des erreurs de construction contre le paquet
204
live-build, des erreurs en temps de démarrage contre live-boot, et erreurs
205
d'exécution contre live-config. Si vous n'êtes pas sûr de quel paquet est
206
approprié ou avez besoin d'aide avant de soumettre un rapport de bogue, s'il
207
vous plaît envoyez un message à la liste de diffusion et nous vous aiderons
208
à décider.
209
210
S'il vous plaît notez que les bogues trouvés dans les distributions dérivées
211
de Debian (comme Ubuntu et autres) *{ne}* doivent *{pas} * être rapportés au
212
BTS de Debian, sauf qu'ils peuvent être également reproduits sur un système
213
Debian en utilisant les paquets Debian officiels.
Loggerhead is a web-based interface for Breezy
Version: 2.0.1