release/picobsd/doc/src/faq.html

   1 <HTML>
   2 <! $FreeBSD: src/release/picobsd/doc/src/faq.html,v 1.7 1999/08/28 01:33:24 peter Exp $ >
   3 <HEAD>
   4    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   5    <META NAME="Author" CONTENT="Dinesh Nair">
   6    <META NAME="Description" CONTENT="Frequently Asked Questions for PicoBSD">
   7    <META NAME="Keywords" CONTENT="PicoBSD,FreeBSD,Unix,Dinesh Nair,Andrzej Bialecki,Network Computer">
   8    <META NAME="GENERATOR" CONTENT="Mozilla/4.04 [en] (X11; I; FreeBSD 2.2.5-STABLE i386) [Netscape]">
   9    <TITLE>PicoBSD FAQ</TITLE>
  10 </HEAD>
  11 <BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EF" VLINK="#51188E" ALINK="#FF0000">
  12
  13 <CENTER>
  14 <H1>
  15 The PicoBSD FAQ
  16 </H1></CENTER>
  17
  18 <CENTER>
  19 <HR WIDTH="100%"></CENTER>
  20 <p><B>What is PicoBSD ?</B></p>
  21
  22 <P>PicoBSD is a floppy sized version of popular operating system FreeBSD.
  23 It fits within a single bootable 1.44MB floppy and runs on a minimum i386
  24 with 8MB RAM. PicoBSD currently comes in four flavours: dialup, net, router and
  25 isp. For a description of how each of the flavours differ, take a look
  26 at the <B><A HREF="http://www.freebsd.org/~picobsd/picobsd.html">PicoBSD
  27 home page</A></B>.
  28
  29 <p><B>What is this "pico" in the name?</B></p>
  30
  31 <p>It's an SI measure unit, which is equivalent of 10e<sup>-12</sup>.
  32 This is a good approximation of more colloquial "extremely small".</p>
  33
  34 <p>You can also think of normal FreeBSD as a system infested with
  35 fully grown daemons, and PicoBSD as a system infested with
  36 "the little people" :-). </p>
  37
  38 <P><B>What version of FreeBSD is PicoBSD based on ?</B></p>
  39
  40 <P>PicoBSD has versions based on FreeBSD 3.2-RELEASE, 4.0-current and
  41 FreeBSD 2.2.5-RELEASE.
  42 <A HREF="mailto:abial@freebsd.org">Andrzej Bialecki</A> maintains the <A HREF="http://www.freebsd.org/~picobsd/picobsd.html">FreeBSD
  43 3.x-RELEASE and -current versions</A> and
  44 <A HREF="mailto:dinesh@alphaque.com">Dinesh Nair</A>
  45 maintains the <A HREF="http://info.net-gw.com/picoBSD/">FreeBSD
  46 2.2.5-RELEASE</A> version. Both the versions are different:
  47 <UL TYPE=CIRCLE>
  48 <LI>
  49 the 3.x-RELEASE version is the one actively maintained, and provides support
  50 for many new devices</li>
  51
  52 <LI>
  53 the 2.2.5-RELEASE version is not maintained anymore - the only difference is
  54 that it has lynx on board.</li>
  55 </UL>
  56
  57 <p><b>What is current version of PicoBSD?</b></p>
  58
  59 <p>Current version of PicoBSD is @VER@.</p>
  60
  61 <P><B>What can PicoBSD do?</B></p>
  62
  63 <P>With the TCP/IP capabilities of FreeBSD included in and based on the
  64 strong 4.4BSD TCP/IP stack, PicoBSD can be used as a low cost Network Computer.
  65 With a text based HTML 3.2 compliant browser (2.2.5-RELEASE version only)
  66 and Internet access tools such as telnet and ftp, it can serve as a low
  67 cost Internet dialup client. With support for mounting MSDOS and Unix harddisks,
  68 it also can be used as a portable OS which you can carry around in a floppy.
  69 The net and isp flavours would allow you to make use of those redundant
  70 i386es as a low cost router or dialin PPP server. With SNMP and firewall
  71 support built-in, PicoBSD provides the functionality of dedicated routers
  72 and dialin terminal servers.
  73
  74 <P><B>What are PicoBSD's minimum requirements?</B></p>
  75
  76 <P>PicoBSD runs on a minimum i386 with 8MB RAM for the dialup flavour and
  77 10MB RAM for the net and isp flavours. Diskspace requirements are a single
  78 1.44MB floppy. For on-demand PPP access, a modem would be required, either
  79 external or internal.
  80 For LAN access, an Ethernet NIC (support for 3Com, NE2000 etc available)
  81 would also be required.
  82 <p>In case of "router" flavor, its requirements are even smaller: it can
  83 run in as low as 4MB of RAM, on a 386SX CPU.</p>
  84
  85 <P><B>Where do I get PicoBSD?</B></p>
  86  PicoBSD is available at the following
  87 locations:
  88 <UL TYPE=CIRCLE>
  89 <LI>
  90 <A HREF="http://www.freebsd.org/~picobsd/picobsd.html">PicoBSD based on
  91 FreeBSD 3.0-RELEASE and -current</A> maintained by Andrzej Bialecki</LI>
  92
  93 <LI>
  94 <A HREF="http://info.net-gw.com/picoBSD/">PicoBSD based on FreeBSD 2.2.5-RELEASE</A>
  95 prepared by Dinesh Nair</LI>
  96 </UL>
  97 Additional mirror sites will be brought online as demand increases. If
  98 you're interested in mirroring the PicoBSD distribution, please get in
  99 touch with <A HREF="mailto:dinesh@alphaque.com">Dinesh Nair</A> or
 100 <A HREF="mailto:abial@freebsd.org">Andrzej Bialecki</A>.
 101
 102 <P><B>How do I copy it to the floppy?</B></p>
 103
 104 <P>The binary images provided as part of the PicoBSD distribution are 1.44MB
 105 sized floppy images. They cannot be copied to a floppy using the <I>MSDOS
 106 COPY</I> or <I>Unix cp</I> commands. Instead, an image copy must be done
 107 using tools such as&nbsp; <A HREF="ftp://ftp.freebsd.org/pub/FreeBSD/tools/rawrite.exe">rawrite.exe</A>
 108 or f<A HREF="ftp://ftp.freebsd.org/pub/FreeBSD/tools/fdimage.exe">dimage.exe</A>
 109 under MSDOS and <B>dd</B> under Unix.
 110
 111 <P>Under DOS you would do something like this:
 112 <UL>
 113 <PRE><B>C:\> fdimage.exe picobsd.flp a:</B></PRE>
 114 </UL>
 115 while under Unix you would use something like:
 116 <UL><B>dd if=picobsd.flp of=/dev/rfd0</B></UL>
 117
 118 <p><B>How do I configure dialup PPP access on the Dialup flavour?</B></p>
 119
 120 <P>There is an auto-configuration script to configure PPP dialup access.
 121 Run <I>/stand/dialup</I> after booting up from the floppy and make the
 122 relevant menu selections. Once you've tested it to work, you should make
 123 your changes permanent by committing them to the floppy using <I>/stand/update</I>.
 124
 125 <P><B>How do I set my DNS server ?</B></p>
 126
 127 <P>Use the provided <I>/stand/ee</I> editor and edit <I>/etc/resolv.conf</I>.
 128 Replace the <U>domain</U> with your domain and change the <U>nameserver</U>
 129 IP address to your nameserver or your ISP's nameserver. You may have as
 130 many <U>nameserver</U> lines as you want. Don't forget to run <I>/stand/update</I>
 131 to commit your changes to the floppy.
 132 <p>NOTE: starting with version 0.4, the <i>dialup</i> script asks you to
 133 set your nameserver as well as default domain name.</p>
 134
 135 <p><b>I can't execute the <i>/stand/update</i> on the "router" floppy.</b></p>
 136 <p>The "router" floppy doesn't contain any real shell, so some commands work
 137 differently (and some don't work at all). In order to use this script you
 138 have to 'source it in', i.e.:
 139 <pre>
 140         (48)/# pwd
 141         /
 142         (48)/# . /stand/update
 143 </pre>
 144
 145 <P><B>How do I set my hostname ?</B></p>
 146
 147 <P>Edit /<I>etc/rc.conf</I> and change the value of the <U>hostname</U>
 148 variable.
 149
 150 <p><b>PicoBSD has "mkdir" but not "rmdir". How can I delete
 151 subsdirectories?</b></p>
 152 <p>"rm -d" will delete directories.</p>
 153
 154 <p><b>Can I use a modem configured on COM3/COM4 instead of COM1, COM2?</b></p>
 155
 156 <p>Yes, but these ports are initially disabled - most machines have only
 157 two serial ports anyway. You have to enable them in UserConfig.</P>
 158 <p>Here are the preferred settings:</p>
 159 <ul>
 160 <li>    sio0=COM1: port 0x3f8, irq 4, used by default for mouse (/dev/cuaa0)
 161 </li>
 162 <li>    sio1=COM2: port 0x2f8, irq 3, used by default for modem (/dev/cuaa1)
 163 </li>
 164 <li>    sio2=COM3: port 0x3e8, irq 5, disabled by default
 165 </li>
 166 <li>    sio3=COM4: port 0x2e8, irq 10, disabled by default
 167 </li>
 168 </ul>
 169
 170 <p><b>I see a configuration conflict the first time I boot PicoBSD. What
 171 should I do?</b></p>
 172
 173 <p>Disable those devices which are not present in your machine. If there is
 174 still some conflict, change the settings (I/O port, IRQ etc.).</p>
 175
 176 <p><b>Exception:</b> if you're using a PS/2 mouse, the visual configuration
 177 tool will display CONF for sc0 and psm0. The default settings are correct,
 178 and you should simply ignore the warning.</p>
 179
 180 <p><b>What kind of SCSI support is there?</b></p>
 181
 182 <p>None. Either build your own version of PicoBSD, or just install normal
 183 FreeBSD distribution.</p>
 184
 185 <p><b>Using version 0.4 I get many  strange messages on my console...</b></p>
 186 <p>This is related in large part to DEVFS subsystem - it is still somewhat
 187 experimental, and its author left some diagnostics turned on.. They are
 188 harmless. Versions 0.4x, x>0 don't use DEVFS at all, as it was too
 189 experimental to work reliably...</p>
 190
 191 <P><B>How do I connect using PPP ?</B></p>
 192
 193 <P>Just run the PPP process, <I>/stand/ppp</I>. at the <B>ppp on pico></B>
 194 prompt, type <U>dial</U> and sit back and wait for the modem to sing it's
 195 mating tunes. When the <B>ppp on pico></B> prompt is capitalized to <B>PPP
 196 on pico></B>, you've managed to succesfully achieve a link-level PPP and
 197 TCP/IP connection with your ISP. Additionally, the PPP program will enter
 198 <I>Packet Mode</I>. Remember, don't <U>quit</U> or <U>close</U> the PPP
 199 connection if you want to continue to access the Internet.&nbsp; Type <U>help</U>
 200 at the <B>ppp on pico></B> prompt for a list of PPP commands.
 201
 202 <P><B>The PPP process is running on my screen. How do I use the browser
 203 or telnet to a host ?</B></p>
 204
 205 <P>PicoBSD has many virtual terminals, 10 on the dialup flavour. You have
 206 run PPP on the first virtual terminal. You can switch to the others and
 207 run the browser and telnet clients there. Switching thru the VTs is done
 208 by ALT-F1 for VT0, ALT-F2 for VT1, ALT-F3 for VT2 etc. From these terminals,
 209 you could use telnet or the lynx browser cum newsreader.
 210
 211 <p><b>I can't establish a PPP connection. The mouse pointer randomly appears
 212 and disappears. and moving the mouse has no effect.</b></p>
 213
 214 <p>You have the mouse driver configured to use the modem's serial port.
 215 Issue a 'ps -ax', remember the pid (process ID) of 'moused', then issue a
 216 'kill -9 <pid>'. Edit /etc/rc.conf to specify the correct mouse port. Issue
 217 an 'update' commmand to save new configuration to the floppy, and reboot.</p>
 218
 219 <P><B>I saved my lynx configuration but it was not there when I rebooted.
 220 Why ?</B>
 221
 222 <P>The lynx configuration is saved in <I>/etc/lynx.cfg</I>. You should
 223 run /<I>stand/update</I> to commit this to the floppy when you change the
 224 configuration. In effect, anything you change in /etc can be committed
 225 by running /<I>stand/update</I>.
 226
 227 <P><B>How come there are no manual pages ?</B></p>
 228
 229 <P>Well, this is a floppy-sized OS, so there's not enough space for full
 230 manpages. Instead, short help descriptions are given with the <I>/stand/help</I>
 231 program. If you need more detailed descriptions, take a look at the <A HREF="http://www.freebsd.org/handbook/">FreeBSD
 232 Handbook</A> or the <A HREF="http://www.freebsd.org/">FreeBSD Home</A>.
 233 <BR>&nbsp;
 234 <BR>&nbsp;
 235 <HR WIDTH="100%">
 236 <CENTER><FONT SIZE=-1>More FAQ points will be added as feedback from the
 237 PicoBSD user community comes in. And big thanks to all of you who already
 238 sent us some suggestions!</FONT></CENTER>
 239 <P><B><FONT SIZE=-1>Last Modified:
 240 @DATE@
 241 </FONT></B></P>
 242 </BODY>
 243 </HTML>