summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Andersen2004-10-08 10:50:08 +0000
committerEric Andersen2004-10-08 10:50:08 +0000
commit6c4a6b1a231a04d2993615885139a43f4294b96f (patch)
tree7e9e21eb75a724e4b5a00d9be62c076b03222ec4
parentad63cb25140996588f223b009b094f1408a52a4b (diff)
downloadbusybox-6c4a6b1a231a04d2993615885139a43f4294b96f.zip
busybox-6c4a6b1a231a04d2993615885139a43f4294b96f.tar.gz
Add an initial FAQ
-rw-r--r--docs/busybox.net/FAQ.html302
-rw-r--r--docs/busybox.net/header.html1
2 files changed, 303 insertions, 0 deletions
diff --git a/docs/busybox.net/FAQ.html b/docs/busybox.net/FAQ.html
new file mode 100644
index 0000000..70c1a90
--- /dev/null
+++ b/docs/busybox.net/FAQ.html
@@ -0,0 +1,302 @@
+<!--#include file="header.html" -->
+
+
+<h3>Frequently Asked Questions</h3>
+
+This is a collection of some of the more frequently asked questions
+about BusyBox. Some of the questions even have answers. If you
+have additions to this FAQ document, we would love to add them,
+
+<ol>
+<li><a href="#kernel">Which Linux kernel versions are supported?</a>
+<li><a href="#arch">Which architectures does BusyBox run on?</a>
+<li><a href="#libc">Which C libraries are supported?</a>
+<li><a href="#commercial">Can I include BusyBox as part of the software on my device?</a>
+<li><a href="#bugs">I think I found a bug in BusyBox! What should I do?!</a>
+<li><a href="#job_control">Why do I keep getting "sh: can't access tty; job control
+ turned off" errors? Why doesn't Control-C work within my shell?</a>
+<li><a href="#demanding">I demand that you to add &lt;favorite feature&gt; right now! How come
+ you don't answer all my questions on the mailing list instantly? I demand
+ that you help me with all of my problems <em>Right Now</em>!</a>
+<li><a href="#helpme">I need help with BusyBox! What should I do?</a>
+<li><a href="#contracts">I need you to add &lt;favorite feature&gt;! Are the BusyBox developers willing to
+ be paid in order to fix bugs or add in &lt;favorite feature&gt;? Are you willing to provide
+ support contracts?</a>
+<li><a href="#support">I think you guys are great and I want to help support your work!</a>
+
+
+</ol>
+
+
+<hr />
+<p>
+<h2><a name="kernel">Which Linux kernel versions are supported?</a></h2>
+<p>
+
+
+ Full functionality requires Linux 2.2.x or better. A large fraction of the
+ code should run on just about anything. While the current code is fairly
+ Linux specific, it should be fairly easy to port the majority of the code
+ to support, say, FreeBSD or Solaris, or Mac OS X, or even Windows (if you
+ are into that sort of thing).
+
+
+<hr />
+<p>
+<h2><a name="arch">Which architectures does BusyBox run on?</a></h2>
+<p>
+
+
+ BusyBox in general will build on any architecture supported by gcc.
+ Kernel module loading for 2.2 and 2.4 Linux kernels is currently
+ limited to ARM, CRIS, H8/300, x86, ia64, x86_64, m68k, MIPS, PowerPC,
+ S390, SH3/4/5, Sparc, v850e, and x86_64 for 2.4.x kernels.
+
+ With 2.6.x kernels, module loading support should work on all architectures.
+
+
+<hr />
+<p>
+<h2><a name="libc">Which C libraries are supported?</a></h2>
+<p>
+
+
+ uClibc and glibc are supported. People have been looking at newlib and
+ dietlibc, but they are currently considered unsupported, untested, or
+ worse. Linux-libc5 is no longer supported. If you require a small C
+ library, you should probably use uClibc.
+
+
+<hr />
+<p>
+<h2><a name="commercial">Can I include BusyBox as part of the software on my device?</a>
+
+ Yes. As long as you <a href="http://busybox.net/license.html">fully comply
+ with the generous terms of the GPL BusyBox license</a> you can ship BusyBox
+ as part of the software on your device.
+
+ <a href="#support">Please consider sharing some of the money you make.</a>
+
+
+<hr />
+<p>
+<h2><a name="bugs">I think I found a bug in BusyBox! What should I do?</h2>
+<p>
+
+ If you find a problem with BusyBox, please submit a detailed bug report to
+ the BusyBox mailing list at <a href="mailto:busybox@mail.busybox.net">
+ busybox@mail.busybox.net</a>. Please do not send private email to Erik
+ (the maintainer of BusyBox) asking for private help unless you are planning
+ on paying for consulting services. When we answer questions on the BusyBox
+ mailing list, it helps everyone, while private answers help only you...
+
+ <p>
+
+ If you find bugs, please submit a detailed bug report to the BusyBox mailing
+ list at busybox@mail.busybox.net. A well-written bug report should include a
+ transcript of a shell session that demonstrates the bad behavior and enables
+ anyone else to duplicate the bug on their own machine. The following is such
+ an example:
+
+<pre>
+ To: busybox@mail.busybox.net
+ From: diligent@testing.linux.org
+ Subject: /bin/date doesn't work
+
+ Package: BusyBox
+ Version: 1.00
+
+ When I execute BusyBox 'date' it produces unexpected results.
+ With GNU date I get the following output:
+
+ $ date
+ Fri Oct 8 14:19:41 MDT 2004
+
+ But when I use BusyBox date I get this instead:
+
+ $ date
+ illegal instruction
+
+ I am using Debian unstable, kernel version 2.4.27 on a x86 system,
+ and the latest uClibc from CVS. Thanks for the wonderful program!
+
+ -Diligent
+</pre>
+
+ Note the careful description and use of examples showing not only what BusyBox
+ does, but also a counter example showing what an equivalent GNU app does. Bug
+ reports lacking proper detail may never be fixed... Thanks for understanding.
+
+<hr />
+<p>
+<h2><a name="job_control">Why do I keep getting "sh: can't access tty; job control
+ turned off" errors? Why doesn't Control-C work within my shell?</a></h2>
+<p>
+
+ Job control will be turned off since your shell can not obtain a controlling
+ terminal. This typically happens when you run your shell on /dev/console.
+ The kernel will not provide a controlling terminal on the /dev/console
+ device. Your should run your shell on a normal tty such as tty1 or ttyS0
+ and everything will work perfectly. If you <em>REALLY</em> want your shell
+ to run on /dev/console, then you can hack your kernel (if you are into that
+ sortof thing) by changing drivers/char/tty_io.c to change the lines where
+ it sets "noctty = 1;" to instead set it to "0". I recommend you instead
+ run your shell on a real console...
+
+
+<hr />
+<p>
+<h2><a name="demanding">I demand that you to add &lt;favorite feature&gt; right now! How come
+ you don't answer all my questions on the mailing list instantly? I demand
+ that you help me with all of my problems <em>Right Now</em>!</a></h2>
+<p>
+
+ You have not paid us a single cent and yet you still have the product of
+ many years of our work. We are not your slaves! We work on BusyBox
+ because we find it useful and interesting. If you go off flaming us, we
+ will ignore you.
+
+
+<hr />
+<p>
+<h2><a name="helpme">I need help with BusyBox! What should I do?</a></h2>
+<p>
+
+ If you find that you need help with BusyBox, you can ask for help on the
+ BusyBox mailing list at busybox@mail.busybox.net. In addition to the BusyBox
+ mailing list, Erik (andersee), Manuel (mjn3) and others are known to hang out
+ on the uClibc IRC channel: #uclibc on irc.freenode.net.
+
+ <p>
+
+ <b>Please do not send private email to Erik, Manuel, or the other BusyBox
+ contributors asking for private help unless you are planning on paying for
+ consulting services.</b>
+
+ <p>
+
+ When we answer questions on the BusyBox mailing list, it helps everyone
+ since people with similar problems in the future will be able to get help
+ by searching the mailing list archives. Private help is reserved as a paid
+ service. If you need to use private communication, or if you are serious
+ about getting timely assistance with BusyBox, you should seriously consider
+ paying for consulting services.
+
+ <p>
+
+
+
+<hr />
+<p>
+<h2><a name="contracts">I need you to add &lt;favorite feature&gt;! Are the BusyBox
+ developers willing to be paid in order to fix bugs or add in &lt;favorite feature&gt;?
+ Are you willing to provide support contracts?</a></h2>
+<p>
+
+ Sure! Now you have our attention! What you should do is contact <a
+ href="mailto:andersen@codepoet.org">Erik Andersen</a> of <a
+ href="http://codepoet-consulting.com/">CodePoet Consulting</a> to bid
+ on your project. If Erik is too busy to personally add your feature, there
+ are many other active BusyBox contributors who will almost certainly be able
+ to help you out. Erik can contact them and ask them about their availability,
+ and may even ask you to post your request for services on the mailing list.
+
+
+<hr />
+<p>
+<h2><a name="support">I think you guys are great and I want to help support your work!</a></h2>
+<p>
+
+ Wow, that would be great! Erik personally pays for all the bandwidth, and
+ all servers used for busybox.net out of his own pocket. If you would like
+ to make a donation to help support BusyBox, and/or request features, you
+ can click here:
+
+ <!-- Begin PayPal Logo -->
+ <center>
+ <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+ <input type="hidden" name="cmd" value="_xclick">
+ <input type="hidden" name="business" value="andersen@codepoet.org">
+ <input type="hidden" name="item_name" value="Support BusyBox">
+ <input type="hidden" name="image_url" value="https://codepoet-consulting.com/images/codepoet.png">
+ <input type="hidden" name="no_shipping" value="1">
+ <input type="image" src="images/donate.png" name="submit" alt="Make donation using PayPal">
+ </form>
+ </center>
+ <!-- End PayPal Logo -->
+
+ If you prefer to contact Erik directly to make a donation, donate hardware,
+ request support, etc, you can contact
+ <a href="http://codepoet-consulting.com/">CodePoet Consulting</a> here.
+ CodePoet Consulting can accept both Visa and MasterCard for those that do not
+ trust PayPal...
+
+<hr />
+
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+
+<!--#include file="footer.html" -->
+
diff --git a/docs/busybox.net/header.html b/docs/busybox.net/header.html
index 33638f3..77c1418 100644
--- a/docs/busybox.net/header.html
+++ b/docs/busybox.net/header.html
@@ -48,6 +48,7 @@
<br><a href="/lists.html">Mailing Lists</a>
<br><a href="/news.html">Latest News</a>
<br><a href="/download.html">Download</a>
+ <br><a href="/FAQ.html">FAQ</a>
<br><a href="/cvs_anon.html">Accessing CVS</a>
<br><a href="/cgi-bin/cvsweb/busybox/">Browse CVS</a>
<br><a href="/docs.html">Documentation</a>