source: BOOK/final-system/mips/colo.xml @ 49678f8

systemd
Last change on this file since 49678f8 was e611bb9, checked in by Chris Staub <chris@…>, 9 years ago

Fix compile error for colo and colo pages more readable

  • Property mode set to 100644
File size: 4.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-colo" role="wrap">
9  <?dbhtml filename="colo.html"?>
10
11  <title>Colo-&colo-version;</title>
12
13  <indexterm zone="ch-system-colo">
14    <primary sortas="a-Colo">Colo</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Colo package contains the Cobalt Boot Loader.</para>
21
22  </sect2>
23
24  <sect2 role="installation">
25    <title>Installation of Colo</title>
26
27  <note os="a">
28    <para>This bootloader is for the MIPS based cobalt servers RaQ,
29    RaQ2, Qube, or the Qube2.</para>
30  </note>
31
32    <para os="p3">This patch fixes a relocation error when linking with
33    Binutils:</para>
34
35<screen os="p4"><userinput>patch -Np1 -i ../&colo-relocation-patch;</userinput></screen>
36
37    <para os="s1">Disable -Werror in one of the <filename>Makefile</filename>s
38    to prevent a compile failure:</para>
39
40<screen os="s2"><userinput>sed -i '/^CFLAGS/s/-Werror //' stage2/Makefile</userinput></screen>
41
42    <para os="b">Compile the Colo package:</para>
43
44<screen><userinput>make</userinput></screen>
45
46    <para os="c">Install the package:</para>
47
48<screen os="d"><userinput>install -dv  /usr/lib/colo/examples
49install -v chain/colo-chain.elf /usr/lib/colo
50install -v tools/lcdtools/e2fsck-lcd/e2fsck-lcd /sbin
51install -v tools/lcdtools/e2fsck-lcd/e2fsck-lcd.8 /usr/man/man8
52install -v tools/lcdtools/paneld/paneld /sbin
53install -v tools/lcdtools/paneld/paneld.8 /usr/man/man8
54install -v tools/lcdtools/putlcd/putlcd /sbin
55install -v tools/lcdtools/putlcd/putlcd.8 /usr/man/man8
56install -v examples/menu.colo /usr/lib/colo/examples
57install -v examples/simple.colo /usr/lib/colo/examples
58cp -v chain/colo-chain.elf /boot/vmlinux
59gzip -9 /boot/vmlinux</userinput></screen>
60
61  </sect2>
62
63  <sect2 id="contents-colo" role="content">
64    <title>Contents of Colo</title>
65
66    <segmentedlist>
67      <segtitle>Installed programs</segtitle>
68
69      <seglistitem>
70        <seg>colo-chain.elf, e2fsck-lcd, paneld and putlcd</seg>
71      </seglistitem>
72    </segmentedlist>
73
74    <variablelist>
75      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
76      <?dbfo list-presentation="list"?>
77      <?dbhtml list-presentation="table"?>
78
79      <varlistentry id="colo-chain.elf">
80        <term><command>colo</command></term>
81        <listitem>
82          <para>Is the Cobalt Bootloader's chain mode executeable. This
83          file gets gzipped and renamed to <filename>vmlinux.gz</filename>,
84          so it can be booted automatically by the Cobalt's existing
85          firmware</para>
86          <indexterm zone="ch-system-colo colo-chain.elf">
87            <primary sortas="b-colo-chain.elf">colo-chain.elf</primary>
88          </indexterm>
89        </listitem>
90      </varlistentry>
91
92      <varlistentry id="e2fsck-lcd">
93        <term><command>e2fsck-lcd</command></term>
94        <listitem>
95          <para>Will output file system check progress information on the
96          Cobalt LCD</para>
97          <indexterm zone="ch-system-colo e2fsck-lcd">
98            <primary sortas="b-e2fsck-lcd">e2fsck-lcd</primary>
99          </indexterm>
100        </listitem>
101      </varlistentry>
102
103      <varlistentry id="paneld">
104        <term><command>paneld</command></term>
105        <listitem>
106          <para>Is an admin tool for the LCD panel of Cobalt machines. By
107          default, it will display the current time and optionally a message.
108          When you hold the enter or select button for a couple of seconds
109          you will get an admin menu. The menu will allow you to either halt
110          or reboot your Cobalt machine</para>
111          <indexterm zone="ch-system-colo paneld">
112            <primary sortas="b-paneld">paneld</primary>
113          </indexterm>
114        </listitem>
115      </varlistentry>
116
117      <varlistentry id="putlcd">
118        <term><command>putlcd</command></term>
119        <listitem>
120          <para>Is a tool to display text on the LCD display of Cobalt
121          machines</para>
122          <indexterm zone="ch-system-colo putlcd">
123            <primary sortas="b-putlcd">putlcd</primary>
124          </indexterm>
125        </listitem>
126      </varlistentry>
127
128      <varlistentry id="md5rom">
129        <term><command>md5rom</command></term>
130        <listitem>
131          <para>Will output the MD5 checksum of a Cobalt's ROM</para>
132          <indexterm zone="ch-system-colo md5rom">
133            <primary sortas="b-md5rom">md5rom</primary>
134          </indexterm>
135        </listitem>
136      </varlistentry>
137
138    </variablelist>
139
140  </sect2>
141
142</sect1>
Note: See TracBrowser for help on using the repository browser.