aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/mcc-help/en/drakbug_report.xml74
-rw-r--r--docs/mcc-help/en/otherMageiaTools.xml18
2 files changed, 88 insertions, 4 deletions
diff --git a/docs/mcc-help/en/drakbug_report.xml b/docs/mcc-help/en/drakbug_report.xml
new file mode 100644
index 00000000..e4fc98aa
--- /dev/null
+++ b/docs/mcc-help/en/drakbug_report.xml
@@ -0,0 +1,74 @@
+<?xml version='1.0' encoding='utf-8'?><section
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xlink="http://www.w3.org/1999/xlink"
+xmlns:ns5="http://www.w3.org/1998/Math/MathML"
+xmlns:ns4="http://www.w3.org/2000/svg"
+xmlns:ns3="http://www.w3.org/1999/xhtml"
+xmlns:ns="http://docbook.org/ns/docbook"
+xml:id="drakbug_report" version="5.0">
+
+ <info>
+ <title xml:id="drakbug_report-ti1">Collect Logs and System Information
+ for Bug Reports</title><subtitle>drakbug_report</subtitle>
+ </info>
+
+ <para>This tool<footnote><para>You can start this tool from the command
+ line, by typing <emphasis role="bold">drakbug_report</emphasis> as
+ root.</para></footnote> can only be started and used on the command
+ line.</para>
+
+<para>It is advised to write the output of this command to a file, for
+ instance by doing <emphasis role="bold">drakbug_report >
+ drakbugreport.txt</emphasis>, but make sure you have enough disk space
+ first: the file can easily be several GBs large.</para>
+<note><para>The output is far too large to attach to a bug report without
+first removing the unneeded parts.</para></note>
+ <para>This command collects the following information on your system:</para>
+
+ <itemizedlist>
+ <listitem><para> lspci</para></listitem>
+ <listitem><para> pci_devices</para></listitem>
+ <listitem><para> dmidecode</para></listitem>
+ <listitem><para> fdisk</para></listitem>
+ <listitem><para> scsi</para></listitem>
+ <listitem><para> /sys/bus/scsi/devices</para></listitem>
+ <listitem><para> lsmod</para></listitem>
+ <listitem><para> cmdline</para></listitem>
+ <listitem><para> pcmcia: stab</para></listitem>
+ <listitem><para> usb</para></listitem>
+ <listitem><para> partitions</para></listitem>
+ <listitem><para> cpuinfo</para></listitem>
+ <listitem><para> syslog</para></listitem>
+ <listitem><para> Xorg.log</para></listitem>
+ <listitem><para> monitor_full_edid</para></listitem>
+ <listitem><para> stage1.log</para></listitem>
+ <listitem><para> ddebug.log</para></listitem>
+ <listitem><para> install.log</para></listitem>
+ <listitem><para> fstab</para></listitem>
+ <listitem><para> modprobe.conf</para></listitem>
+ <listitem><para> lilo.conf</para></listitem>
+ <listitem><para> grub: menu.lst</para></listitem>
+ <listitem><para> grub: install.sh</para></listitem>
+ <listitem><para> grub: device.map</para></listitem>
+ <listitem><para> xorg.conf</para></listitem>
+ <listitem><para> urpmi.cfg</para></listitem>
+ <listitem><para> modprobe.preload</para></listitem>
+ <listitem><para> sysconfig/i18n</para></listitem>
+ <listitem><para> /proc/iomem</para></listitem>
+ <listitem><para> /proc/ioport</para></listitem>
+ <listitem><para> mageia version</para></listitem>
+ <listitem><para> rpm -qa</para></listitem>
+ <listitem><para> df</para></listitem>
+ </itemizedlist>
+
+
+ <note><para>At the time this help page was written, the "syslog" part of
+ this command's output was empty, because this tool had not yet been
+ adjusted to our switch to systemd. If it is still empty, you can
+ retrieve the "syslog" by doing (as root) <emphasis role="bold">
+ journalctl -a > journalctl.txt</emphasis>. If you don't have a lot of
+ diskspace, you can, for instance, take the last 5000 lines of the log
+ instead with: <emphasis role="bold">journalctl -a | tail -n5000 >
+ journalctl5000.txt</emphasis>.</para></note>
+
+</section>
diff --git a/docs/mcc-help/en/otherMageiaTools.xml b/docs/mcc-help/en/otherMageiaTools.xml
index 5b9c850b..a8c4dbba 100644
--- a/docs/mcc-help/en/otherMageiaTools.xml
+++ b/docs/mcc-help/en/otherMageiaTools.xml
@@ -8,23 +8,33 @@
<orderedlist>
<listitem>
- <para><xref linkend="drakbug"/></para>
+ <para><xref linkend="drakbug"/><emphasis>drakbug</emphasis>
+ </para>
</listitem>
+ <listitem>
+ <para><xref linkend="drakbug_report"/><emphasis>drakbug_report
+ </emphasis></para>
+ </listitem>
+
<listitem>
- <para><xref linkend="lsnetdrake"/><emphasis>TO BE WRITTEN</emphasis></para>
+ <para><xref linkend="lsnetdrake"/><emphasis>TO BE WRITTEN
+ </emphasis></para>
</listitem>
<listitem>
- <para><xref linkend="lspcidrake"/><emphasis>TO BE WRITTEN</emphasis></para>
+ <para><xref linkend="lspcidrake"/><emphasis>TO BE WRITTEN
+ </emphasis></para>
</listitem>
<listitem>
- <para>And more tools?</para>
+ <para>And more tools?</para>
</listitem>
</orderedlist>
<xi:include href="drakbug.xml"></xi:include>
+ <xi:include href="drakbug_report.xml"></xi:include>
+
<xi:include href="lsnetdrake.xml"></xi:include>
<xi:include href="lspcidrake.xml"></xi:include>