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