[Demudi-commits] r91 - in demudi-trac/trunk: . wiki
Free Ekanayaka
free-guest@haydn.debian.org
Thu, 04 Nov 2004 04:37:48 -0700
Author: free-guest
Date: 2004-11-04 04:37:01 -0700 (Thu, 04 Nov 2004)
New Revision: 91
Added:
demudi-trac/trunk/wiki/
demudi-trac/trunk/wiki/ContactsChat
demudi-trac/trunk/wiki/ContactsLists
demudi-trac/trunk/wiki/DevelopBugs
demudi-trac/trunk/wiki/DevelopCode
demudi-trac/trunk/wiki/DocumentsConcept
demudi-trac/trunk/wiki/DocumentsFAQ
demudi-trac/trunk/wiki/DocumentsHistory
demudi-trac/trunk/wiki/DownloadApt
demudi-trac/trunk/wiki/DownloadCdRom
demudi-trac/trunk/wiki/InstallApt
demudi-trac/trunk/wiki/InstallCdRom
demudi-trac/trunk/wiki/LinksAudio
demudi-trac/trunk/wiki/LinksDebian
demudi-trac/trunk/wiki/LinksLinux
demudi-trac/trunk/wiki/WikiStart
Log:
Added contents
Added: demudi-trac/trunk/wiki/ContactsChat
===================================================================
--- demudi-trac/trunk/wiki/ContactsChat 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/ContactsChat 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,19 @@
+= The AGNULA IRC channel =
+
+If you want to communicate with users and developers in real-time, you can join our #agnula [http://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] channel on the [http://www.freenode.net Freenode Network].
+
+
+== How To Join The AGNULA Channel ==
+
+All you need to join this conversation is an IRC client program. There are numerous IRC clients available. Check out [http://irssi.org/ irssi] or [http://www.bitchx.org/ bitchx] for GNU/Linux. A popular proprietary client program for Microsoft Windows is [http://www.mirc.com Mirc]. It is [http://www.mirc.com/get.html available without charge].
+
+If you want to learn more about IRC usage and the Freenode network, [http://www.freenode.net visit the Freenode website].
+
+== About The #AGNULA Channel ==
+
+The channel is a place where users and developers communicate alike. Since developers tend to be very busy people at times, please stay a while if nobody seems to answer your questions. Please give us some extra time to respond - we might not be looking at our IRC client windows just now.
+
+
+Some people in the channel change their nickname to display if they are working busily ("nickname|w") or away from keyboard ("nickname|afk" or "nickn_afk"). Please note that this is considered very impolite in some of the big channels on the freenode network, like #debian and alike. But people in #agnula just love it.
+
+
Added: demudi-trac/trunk/wiki/ContactsLists
===================================================================
--- demudi-trac/trunk/wiki/ContactsLists 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/ContactsLists 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,32 @@
+= The AGNULA Mailing Lists =
+
+AGNULA is a collaborative project. Everything is coordinated and discussed in our mailing lists.
+
+== The Users Mailing List ==
+
+The [http://lists.agnula.org/mailman/listinfo/users users list] is the central mailing list of the AGNULA project. It is meant to discuss everything related to the project, ask questions about problems you might experience with !DeMuDi and share your success stories, opinions, ideas and music. If you are not sure whom to contact with your input, subscribe to the users list.
+
+Please take note of the [http://lurker.agnula.org/list/users_at_lists_agnula_org.html users list archive], which is easy to search.
+
+== The Developers Mailing List ==
+
+The [http://lists.agnula.org/mailman/listinfo/developers developers list] is for technical discussions between developers of the AGNULA project.
+
+This list also has [http://lurker.agnula.org/list/developers_at_l_a_o.html its searchable archive].
+
+== The Announcements Mailing List ==
+
+If you wish to be informed on what's happening in the AGNULA world in a somewhat more concise way, you can subscribe to our [http://lists.agnula.org/mailman/listinfo/announce announcements mailing list], which also contains press releases.
+
+The announcements list also has [http://lurker.agnula.org/list/announce_at_l_a_o.html its searchable archive].
+
+== The AGNULA Newsletter ==
+
+The AGNULA Newsletter contains news from the project and from the GNU/Linux audio world in general. [...] To receive the newsletter, please [http://lists.agnula.org/mailman/listinfo/newsletter-dist register to the newsletter-dist mailing list]. To read previous issues, please refer to the [http://lurker.agnula.org/list/ndist_at_l_a_o.html newsletter-dist archive].
+
+If you have a news item that should appear in the AGNULA newsletter, please [mailto:newsNOSPAMletter-collect@lists.agnula.org send an email to newsNOSPAMletter-collect@lists.agnula.org]. Please remove all the capital letters from this email adress, or your email won't get through.
+
+== The CVS Commits Mailing List ==
+
+If you want to track the development of !DeMuDi, you can [http://lists.agnula.org/mailman/listinfo/commits/ subscribe to the CVS commits mailing list], where every change to the [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS] repository is announced. Like all of our mailing lists, this one has [http://lurker.agnula.org/list/commits_at_l_a_o.html its searchable archive], too.
+
Added: demudi-trac/trunk/wiki/DevelopBugs
===================================================================
--- demudi-trac/trunk/wiki/DevelopBugs 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DevelopBugs 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,17 @@
+= How to report a bug =
+
+Problems with any official Debian packages should be submitted directly to the
+[http://bugs.debian.org Debian BTS]
+
+The easiest way to do this is through the Debian reportbug program. The reportbug
+program has a lot of options, but in its simplest form, you can just say:
+
+{{{
+ reportbug package-name
+}}}
+
+and it will do the right thing. Be sure that you check the BTS first, before
+filing your bug, to avoid filing a duplicate bug.
+
+Problems with non-official Debian packages, should never be submitted to the
+Debian BTS. Instead, email FILL WITH DEMUDI MAILING LIST.
Added: demudi-trac/trunk/wiki/DevelopCode
===================================================================
--- demudi-trac/trunk/wiki/DevelopCode 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DevelopCode 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,37 @@
+= DeMuDi source code =
+
+The !DeMuDi project uses [http://subversion.tigris.org/ Subversion] (''SVN'' for short) as its revision control system.
+
+You can browse the source packages in repository through the
+[http://demudi.alioth.debian.org/browser/ web interface] or
+check it out as anonymous user with:
+
+{{{
+ svn checkout svn://svn.debian.org/svn/demudi/<PACKAGE>/trunk
+}}}
+
+where {{{<PACKAGE>}}} is one of the packages listed by the web
+interface.
+
+If you want to get involved and commit changes please [http://alioth.debian.org/account/register.php register] yourself on [http://alioth.debian.org/ Alioth], and ask to [mailto:free@agnula.org Free Ekanayaka]
+to be added to the project.
+
+Note that your account login name will be '''user-guest''', where '''user''' is the user name you choose in the registration form.
+
+After you creted your Alioth account, you might want to upload your
+[http://www.openssh.com/ SSH] key to the server. If you don't have an
+SSH key, just generate it:
+
+{{{
+ ssh-keygen -t dsa -f ~/.ssh/id_dsa -N ""
+}}}
+
+Now login in your [https://alioth.debian.org/my your personal ALioth page], click
+on ''User Options'' in the upper tab and then ''Modify keys'' at the bottom of the page,
+finally cut and paste your {{{~/.ssh/id_dsa.pub}}} in the form.
+
+To checkout the code as a developer:
+
+{{{
+ svn checkout svn+ssh://user-guest@svn.debian.org/svn/demudi/<PACKAGE>/trunk
+}}}
Added: demudi-trac/trunk/wiki/DocumentsConcept
===================================================================
--- demudi-trac/trunk/wiki/DocumentsConcept 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DocumentsConcept 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,15 @@
+= Concept =
+
+!DeMuDi is not a separate distribution than Debian, it's just a custom
+way to install an ordinary Debian system, which gets automatically
+configured for audio work.
+
+!DeMuDi is basically a snapshot of the forthcoming Debian release, called
+[http://www.debian.org/releases/testing/ "sarge"], plus some non official
+packages contained in our local [wiki:DownloadApt APT repository].
+
+After you install !DeMuDi form the CD-ROM you get a '''pure''' Debian
+system, which has been tuned for audio work.
+
+This means that you have access to the '''whole pool''' of official Debian
+packages, even those not contained in the !DeMuDi CD-ROM.
Added: demudi-trac/trunk/wiki/DocumentsFAQ
===================================================================
--- demudi-trac/trunk/wiki/DocumentsFAQ 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DocumentsFAQ 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,366 @@
+{{{
+#!html
+
+ <h1>DeMuDi 1.2 FAQ</h1>
+
+ <div class="description">Frequently Asked Questions about installing and configuring AGNULA/DeMuDi 1.2.0
+</div>
+
+
+
+
+ <ul>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Installation">Installation</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Configuration">Configuration</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Network">Network</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Permissions">Permissions & ALSA</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#JACK">JACK Audio Connection Kit</a></li>
+
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Xruns">Xruns, interupts, hdparm & runlevels</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Unresolved">Unresolved Issues</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Upgrading">Upgrading existing installations</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Packages">Package Updates</a></li>
+<li><a href="http://demudi.alioth.debian.org/wiki/DocsFAQ#Further">Further Help</a></li>
+</ul>
+ <p>This started out as a simple FAQ for beta-release testers and
+would-be testers, but it appears to have grown into a mini-manual.</p>
+<h1><a name="Installation">Installation</a></h1>
+
+<h2> CD</h2>
+<p> The installer CD is bootable. To boot it, your machine must
+ be configured to boot from the CD-ROM drive before the hard
+ drive in the BIOS. If you don't know how to configure this
+ in your BIOS, don't have the option, or have no idea what
+ this means, just put the CD in your drive and reboot the
+ computer. On many modern machines, booting from CD first
+ is the default, hope that yours is this way.</p>
+<p> The DeMuDi (Debian) installation is divided into two halves.
+ The first half installs a base system, then you will be
+ asked to reboot the computer, and the new base system will
+ boot and finish the configuration and package installation.
+ As we saw in the previous paragraph, your computer will try
+ to boot from the CD-ROM drive if a bootable CD is inserted
+ when it boots up.</p>
+<p> When the installer asks you to reboot the computer, it will
+ ask you to eject the CD-ROM so we can boot from the (newly
+ installed) base system on the hard drive. When you get to
+ the blue GRUB boot screen (with the "aGNUla/DeMuDi: kernel
+ 2.4.25-multimedia" options), please re-insert the CD-ROM.
+ Do not re-insert it prior to this screen. </p>
+
+<hr>
+<h1><a name="Configuration">Configuration</a></h3>
+<p>
+
+Assuming you've followed all the instructions so far, you'll now be gazing at a
+blank fluxbox or GNOME destop depending on whether you chose the 'minimalistic' or'user friendly' interface during installation, but little of it works, at least, not the way you want it to. If you haven't even got that far, you may need to do a little troubleshooting first:</p>
+
+<p> <strong>Q: The X Window graphical systems fails to start</strong></p>
+
+<p> <strong>A</strong>: This is probably due to your video
+ card not being properly detected. You may need to
+ google a little bit to find out if your video
+ card is supported and which is the right module
+ for it. Note also the NVidia cards need
+ propertary drivers which can be found in the
+ non-free section of Debian.<p> Detailed instructions can be found
+<a href="http://lists.agnula.org/pipermail/users/2004-September/003171.html">
+here</a>.</p>
+
+</p>
+
+<p> <strong>Q: I can't get a picture to display at all and my mouse doesn't work</strong></p>
+<p> <strong>A</strong>: You can reconfigure the X server with the command
+<code> # dpkg-reconfigure xserver-xfree86</code>
+or
+<code> # xf86config</code>
+</p>
+
+<p> <strong>Q: At boot no splash image appears and the boot
+ loader looks crappy</strong></p>
+<p> <strong>A</strong>: You've probably created a separate partition for
+ /boot, so that the splash image can't be found.
+ Please either move /boot to the root / partition,
+ or change the paths in /boot/grub/menu.lst
+ accordingly.</p>
+
+
+<p>Choose an XShell you're comfortable with. If you've not used a text interface
+before (i.e. new to GNU/Linux) spend a while getting used to it, you're going to
+need it. Commands prefaced by a <code>$ </code> are to be entered as a normal user, commands with a <code># </code> in front of them need to be entered as root, this is your prompt. (You don't need to type it)
+<p>
+
+To get access to root type: <code>$ su</code> this will ask you for root's password and then allow you to execute commands as root. <code># exit</code> will return you to a normal user. Don't stay logged in as root and pay careful attention to what you are doing (write it down, even), mistakes here are often difficult to resolve, you have been warned! If you want to know more about any of the commands type <code>man <command></code> at the prompt.
+<p>
+<hr>
+<h2><a name="Network">Network</a></h2>
+<p>
+The installer should configure the network for you. If for some reason that hasn't happened then you will need to configure the network by hand.
+
+
+<p> If you use dial-up or PPPOE or something, use <code>pppconfig</code> or
+ <code>pppoeconf</code>.</p>
+<p> If you use DHCP, please become root and run</p>
+<p> <pre># apt-get install etherconf</pre></p>
+<p> Then follow the instructions, and when
+ asked for a domainname, leave the field empty.</p>
+
+<p>If you're on a laptop you may need to configure pcmcia-cs before this will work. As this is a GNU system, there are several different methods you could use for configuration. If you have a preferred method of setting up your network it should also be available and you can always edit <code>/etc/network/interfaces</code> by hand. The information you need to do this is at:
+<pre> # man 5 interfaces
+</pre>You can then bring the network up with:
+<pre> # ifup eth0
+</pre>or whatever interface you are using instead of eth0.
+<p>
+As soon as you're online, open up a web browser and read these:
+<p>
+ <a href="http://www.agnula.org/documentation/FAQ/">http://www.agnula.org/documentation/FAQ/</a><br>
+
+ <a href="http://www.alsa-project.org/alsa-doc/" class='external'>http://www.alsa-project.org/alsa-doc/</a><br>
+ <a href="http://www.debian.org/doc/manuals/reference/reference.en.html" class='external'>http://www.debian.org/doc/manuals/reference/reference.en.html</a><br>
+ <a href="http://d-i.alioth.debian.org/manual/en.i386/index.html" class='external'>http://d-i.alioth.debian.org/manual/en.i386/index.html</a><br>
+ <a href="http://kreiger.linuxgods.com/kiki/?linux+sound-permissions" class='external'>http://kreiger.linuxgods.com/kiki/?linux+sound-permissions</a><br>
+</p>
+<p>
+<hr>
+
+<h2><a name="Permissions">Permissions & ALSA</a></h2>
+
+<p>
+Check that you have the necessary permissions to use the audio devices. <code>vi</code> is used for some of these examples, but again, your favourite text editor will do fine. Make sure your username is in this file next to the <code>audio</code> entry. It should be, by default, so you shouldn't need to change anything here.
+<pre> $ cat /etc/group
+</pre>If you need to add yourself to the list you can use this command:
+<pre> # useradd -G audio username
+</pre><p>
+Next you need to check the permissions of the devices themselves:
+<pre> $ ls -l /dev/dsp* /dev/mixer* /dev/cdrom*
+
+</pre>should give you some output that looks like this:
+<p>
+<pre> lrwxrwxrwx 1 root cdrom 9 2004-08-04 17:47 /dev/cdrom -> /dev/scd0
+ lrwxrwxrwx 1 root cdrom 8 2004-08-02 22:16 /dev/cdrom1 -> /dev/hdc
+ lrwxrwxrwx 1 root audio 9 2004-08-02 22:34 /dev/dsp -> /dev/dsp0
+ crw-rw---- 1 root audio 14, 3 2004-08-02 22:34 /dev/dsp0
+ crw-rw---- 1 root audio 14, 19 2004-08-02 22:34 /dev/dsp1
+ crw-rw---- 1 root audio 14, 35 2004-08-02 22:34 /dev/dsp2
+ crw-rw---- 1 root audio 14, 51 2004-08-02 22:34 /dev/dsp3
+ lrwxrwxrwx 1 root audio 11 2004-08-02 22:34 /dev/mixer -> /dev/mixer0
+ crw-rw---- 1 root audio 14, 0 2004-08-02 22:34 /dev/mixer0
+ crw-rw---- 1 root audio 14, 16 2004-08-02 22:34 /dev/mixer1
+ crw-rw---- 1 root audio 14, 32 2004-08-02 22:34 /dev/mixer2
+ crw-rw---- 1 root audio 14, 48 2004-08-02 22:34 /dev/mixer3
+</pre><p>
+If it doesn't then you may need to perform these moves:
+<pre> # chgrp audio /dev/dsp* /dev/mixer*
+ # chgrp cdrom /dev/cdrom*
+</pre><p>
+
+In this example /dev/cdrom points to the CD Burner, which is a SCSI device. If these links don't point to where you want, then you can change them like this:
+<pre> # rm /dev/cdrom
+ # ln -s /dev/hdc /dev/cdrom
+</pre><p>
+check the settings in:
+<pre> # cat /etc/fstab
+</pre>to check that all your devices are mounted where they should be. If you make changes to this file then you'll need to:
+<pre> # mount -a
+</pre>afterwards.
+<p>
+
+In order to get alsa to function properly you may need to edit <code>/etc/alsa/modutils/1.0</code> and/or <code>/etc/modutils/alsa-base</code> then:
+
+<pre> # update-modules
+</pre>and also
+<pre> $ vi ~/.asoundrc
+</pre><p>
+notice that last command is in your home directory so you don't need to be root, so you shouldn't be ;-).
+<pre> # exit
+</pre>will take you back to the normal prompt. See the <a href='http://www.alsa-project.org/alsa-doc/' class='external'>ALSA website</a> for further details on what to put in these files.
+
+<p>
+There is a really useful script available at <a href="http://alsa.opensrc.org/?aadebug" class='external'>http://alsa.opensrc.org/?aadebug</a> that you can use to check that everything is set up right and to provide some useful info to accompany any further questions. You will need <a href="http://www.debian.org/doc/manuals/reference/ch-tutorial.en.html#s-unixlike" class='external'>a little knowledge of how BASH scripts work</a> to use this. The script is now included with the distribution.
+
+
+<p>
+If you look in your menu; Apps > System > Admin has some useful tools such as <code>alsaconf</code>, if your soundcard failed to autoconfigure. You may need to create the file <code>/etc/alsa/modutils/1.0</code> by hand before this will work. <code>/etc/modutils/alsa-base</code> should be a duplicate of this file. If not copy it across and don't forget to <code>update-modules</code>.
+
+<p>
+
+You may need to log out & back in before these changes take effect.
+
+<p>
+<hr>
+<h2><a name="JACK">Getting to Know JACK</a></h2>
+<p>
+OK, so that's the basic set-up, now you should be hearing some recognisable sound. To check that it's all working properly, it's probably best to go through the exercises in the <a href='http://www.agnula.org/documentation/dp_tutorials/first_steps/' class='external'>First steps in Agnula tutorial</a>.
+<h3>QJackCtl</h3>
+<p>
+Now you've done that, it's time to have a look at <code>qjackctl</code>, that funny little control panel sitting in the middle of your desktop. Hopefully it's already running, if not hit the <code>Start</code> button. All being well you'll see the word <code>Started</code> come up in the window with <code>0 (0)</code> below it. Click on the <code>Connect</code> button and it should show <code>alsa_pcm</code> in both the input and output windows. If so, you're ready to make some music.
+
+<p>
+If you need to alter the way Qjackctl and gkrellm start up look in:
+<pre> # cat /etc/X11/Xsession.d/51demudi.
+</pre><p>
+If it's not all gone so smoothly, click on <code>Messages</code>, if you see anything much more complicated than:
+<pre> 20:19:41.579 Client activated.
+ 20:19:41.583 Audio connection change.
+ 20:19:41.617 Audio connection graph change.
+</pre>then you're going to need to do some work to get the best out of this. If you only want to use one application at a time, you may not need to worry about JACK too much right now. However, if you want the full power of a Linux Audio system then it's worth taking the time to figure this out. The <code>Status</code> button also provides some slightly less verbose information.
+<h3>Setup</h3>
+<h4>Settings tab</h4>
+
+<p>
+The 'Server Path' should be set to <code>jackstart</code> and the 'Driver' to <code>alsa</code>. 'Parameters' - you probably want to check <code>Realtime</code> for most work and <code>Softmode</code> to start with. 'Softmode' means that JACK doesn't quit if you get odd xruns, obviously, you won't want this if you're recording. If you know your machine only works at 16bit resolution check <code>Force 16bit</code>. You'll probably want to leave most settings where they are.
+<p>
+If you're operating in realtime, your 'Priority' should usually be <code>0</code>, but some soundcards differ. 'Frames/Period' worth setting at the maximum to start and then working your way down. This setting affects your latency most directly, setting it too low will result in xruns. 'Sample Rate' probably wants to be <code>44100</code> (CD quality) but some soundcards prefer <code>48000</code> (DAT quality). 'Periods/Buffer' almost certainly wants to be <code>2</code>, but again, your soundcard may vary. ;-) 'Interface' - probably should be <code>hw:0</code> or whatever you specified in your ~/.asoundrc. 'Audio' try 'Playback' only if you're having trouble, mostly you'll want full <code>Duplex</code>. 'Dither' - 'Shaped' is best but CPU hungry, 'Triangular' gives a good compromise, you don't _need_ dithering, so <code>None</code> will do for now. 'Timeout' and 'Start Delay' you might want to consider increasing these in certain situations.
+
+<p>
+OK your new settings <code>Stop</code> if JACK is still running and <code>Start</code> again. You may need to play with the settings a bit to get satisfactory results.
+<p>
+<hr>
+<h2><a name="Xruns">Xruns</a></h2>
+<p>
+During recording sessions, the <code>Messages</code> panel in Qjackctl may report <code>xruns</code>. Xruns are basically an indications that while Jack is running something gets in the way of it running correctly and it becomes unable to cope with the flow of data causing dropouts in the sound. Let's look at the possibilities:
+
+<h3>Interrupts</h3>
+<p>
+If some other card has a higher priority then when it generates an interrupt, if it's slow responding, then possibly Jack and the sound card cannot get their job done.
+<p>
+<pre> # cat /proc/interrupts
+</pre><p>
+and
+<p>
+<pre> # lspci -v
+</pre><p>
+will give you some valuable information here. Generally speaking, you want your soundcard to be in the highest priority slot (9 or 10) and not sharing with anything. Solutions mostly involve physically moving the soundcard up to a higher slot and/or disabling unused hardware in the BIOS.
+<h3>Hard drive speed is too slow</h3>
+<p>
+
+<pre> # hdparm -tT /dev/hda
+</pre>(or whatever drive you use for audio) A/DeMuDi installs with optimal settings for most drives. You shouldn't need to edit <code>/etc/hdparm.conf</code> unless you know you do. You can cause irreversible data corruption messing with these settings. Read:
+<pre> # man hdparm
+</pre>before you attempt anything.
+<h3>Too many processes running</h3>
+<p>
+Processes that interrupt system operation on a regular basis can also cause xruns, although technically this shouldn't be a problem for a powerful enough machine running a low-latency kernel.
+
+<pre> $ ps fax
+</pre>will show you all the processes currently running on your box. One way of cutting down on running processes is to specify a runlevel that is reserved for making music, for example <code>/etc/rc5.d</code>, the default runlevel is <code>/etc/rc2.d</code>. These directories contain links to the scripts that start & stop essential services, usually when you boot up and shut down. Each of these links starts with <code>S##</code>, change the non-essential services to <code>K##</code> using your favourite runlevel editor (again, plenty of choice). Likely candidates for removal are anacron, klogd & cron, most are inessential apart from the obviously music related ones. You can then change runlevels by issuing:
+
+<pre> # telinit 5
+</pre>or whatever level number you chose. It's also worth disabling your screensaver and generally closing down any unused applications or XShells. You can automate this process in the <code>Options</code> tab of Qjackctl's <code>Setup</code> dialog to execute the appropriate commands on startup and shutdown.
+<p>
+<h3>Further Reading</h3>
+<p>
+<a href="http://www.linuxdj.com/audio/quality/" class='external'>http://www.linuxdj.com/audio/quality/</a><br>
+ <a href="http://jackit.sourceforge.net/docs/faq.php" class='external'>http://jackit.sourceforge.net/docs/faq.php</a><br>
+
+ <a href="http://alsa.opensrc.org/" class='external'>http://alsa.opensrc.org/</a><br>
+ <a href="http://linux-sound.org/" class='external'>http://linux-sound.org/</a>
+</pre><p>
+<hr>
+<h1><a name="Unresolved">There's Just One Other Thing ...</a></h1>
+<p> <strong>Q: I've got unresolved symbols!</strong>
+<p> <strong>A</strong>: Yeah, we know.
+<pre> depmod:*** unresolved symbols in /lib/modules/2.4.25-1-multimedia-686/
+kernel/drivers/media/radio/micropcm20.o
+ depmod:*** unresolved symbols in /lib/modules/2.4.25-1-multimedia-686/
+alsa/sndpdaudiocf.o
+ depmod:*** unresolved symbols in /lib/modules/2.4.25-1-multimedia-686/
+alsa/snd-vx-cs.o
+ depmod:*** unresolved symbols in /lib/modules/2.4.25-1-multimedia-686/
+alsa/snd-440.o
+ depmod:*** unresolved symbols in /lib/modules/2.4.25-1-multimedia-686/
+alsa/snd-vxpocket.o
+
+</pre>
+<p>
+You can safely ignore all these messages. The last four are because you haven't installed pcmcia-modules.
+<p> <strong>Q: I think I forgot to configure something else.</strong>
+<p> <strong>A</strong>: If you're worried you've missed something out,
+<pre> # dpkg-reconfigure -a
+</pre>Will take you through the configurations of all packages. This will take some time and concentration.
+<p>
+<hr>
+<h1><a name="Upgrading">Upgrading existing installations</a></h1>
+<p> <strong>Q: Can I upgrade my existing 1.2.0-beta0 installation?</strong></p>
+
+<p> <strong>A:</strong> Yes, please read the Package Updates section below.</p>
+<p> <strong>Q: Can I install A/DeMuDi over an existing Debian
+ installation?</strong></p>
+<p> <strong>A:</strong> Yes, at least as long as you are
+ running Sarge. Follow the following steps</p>
+
+<ul>
+<li>become root</li>
+
+<li>edit your <code>/etc/apt/sources.list</code> adding<p> <pre>deb http://apt.agnula.org/demudi testing main local extra</pre></p>
+</li>
+<li>from the command line issue:<p> <pre># apt-get install demudi-install demudi-base</pre></p>
+</li>
+
+<li>install the tasks you are interested in;
+ to have a look at them run:<p> <pre># apt-cache search demudi</pre></p>
+
+<p> the task <code>demudi</code> installs them all</p>
+</li>
+<li>install the appropriate kernel for your processor:<p> <pre># apt-get kernel-image-2.4.25-1-multimedia-<Type></pre></p>
+<p> where <Type> might be <code>386</code>, <code>586tsc</code>, <code>686</code>, <code>k6</code>, <code>k7</code>,
+ and the relevant ALSA modules too:</p>
+
+<p> <pre># apt-get install alsa-modules-2.4.25-1-multimedia-<TYPE></pre></p>
+</li>
+<li>finally you may want to run some customisation scripts
+ which automatically tune your system:<p> <pre># cfagent-demudi -D postbaseconfig -D upgrade</pre></p>
+</li>
+
+</ul>
+<p> <strong>Q: Can I upgrade my existing 1.0/1.1.0 installation?</strong></p>
+<p> <strong>A:</strong> Yes, using <code>apt</code>.
+See <a href="http://lurker.agnula.org/message/20040616.113908.06d6aea7.html">more info on
+ upgrading</a>.</p>
+
+<p> <strong>Q: Can I upgrade my existing 1.1.1 LiveCD installation?</strong></p>
+<p> <strong>A:</strong> No <em>cannot</em> upgrade a 1.1.1 LiveCD install. It was not meant for hard disk
+ installation, but only for demo porpoises.</p>
+<p> <strong>Q: Is this a LiveCD?</strong></p>
+<p> <strong>A:</strong> No. It requires installation to your hard drive.</p>
+
+
+<hr>
+<h1><a name="Packages">Package Updates</a></h1>
+<p> At some point you may want to update your packages in order to take advantage of upgrades, new software or bug fixes by using Debian's wonderful tool <code>apt</code> (this requires a network connection). Many people like to use a package manager such as dselect or aptitude, if you prefer a point & click GUI, synaptic is very useable.</p>
+<p> To configure <code>apt</code> to grab packages from the network, we
+ need to edit <code>/etc/apt/sources.list</code>. Here is the whole file,
+ but note that the only changes you need
+ to make are uncommenting the two bottom lines, and changing
+ the next-to-last entry to say "testing main local extra".</p>
+
+<p> <pre># cat /etc/apt/sources.list
+deb cdrom:[aGNUla/DeMuDi 1.2.0-beta2 - i386 Binary-1 (20040620)]/ unstable local main
+deb cdrom:[aGNUla/DeMuDi 1.2.0-beta2 - i386 Binary-1 (20040620)]/extra/ unstable main
+deb http://apt.agnula.org/demudi/ testing main local extra
+deb http://snapshot.debian.net/archive/2004/07/14/debian/ testing main contrib non-free</pre></p>
+<p> Now that apt is configured, let's get all the updated
+ packages:</p>
+<p> <code># upgrade-demudi</code></p>
+<hr>
+<h1><a name="Further">And beyond ...</a></h1>
+<p>
+Next you'll be wanting to try out some of these wonderful Linux Audio applications, so we'll leave you in the capable hands of Dave Phillips and his excellent <a href='http://www.agnula.org/documentation/dp_tutorials/' class='external'>Tutorials</a>.
+
+<p> If by some strange chance you find a bug ;-) please submit
+ a bug report at the <a href="http://devel.agnula.org/tracker/?group_id=8">development GForge portal</a>.</p>
+<p> If you want to discuss this FAQ or write a HOW-TO yourself, log in and make a contribution.
+<p> Subscribe to the <a href="http://www.agnula.org/lists/">mailing
+ lists</a> and let us know what you think.</p>
+<p>
+
+Other previously answered questions are available at the
+<a href='http://lurker.agnula.org/splash/index.html' class='external'>mailing list archives</a>.
+Yes, this is a hint. ;)
+<p> Make some great <a href="http://muzik.agnula.org">music</a>!
+</p>
+
+
+
+</div>
+}}}
Added: demudi-trac/trunk/wiki/DocumentsHistory
===================================================================
--- demudi-trac/trunk/wiki/DocumentsHistory 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DocumentsHistory 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,70 @@
+= History =
+
+== Early times ==
+In 1998 the situation of sound/music Free Software applications had
+already reached what could be considered well beyond initial
+pioneeristic stage. A [http://linux-sound.org/ website], maintained
+by musician and GNU/Linux enthusiast Dave Phillips, was already
+collecting all possible sound and music software running on GNU/Linux architectures.
+At that time, the biggest problem was that all these applications
+were dispersed over the Internet: there was no common operational
+framework and each and every application was a case-study by itself.
+
+== First try ==
+
+A natural development followed shortly after, when
+musician/composer/programmer Marco Trevisani proposed a to a small
+group of friends (Nicola Bernardini, Maurizio De Cecco, Davide
+Rocchesso and Roberto Bresin) to create LAOS (''Linux Audio Open Sourcing''),
+a binary distribution of all essential sound/music tools available
+at the time including website diffusion and support. LAOS came up
+too early, and it did not go very far.
+
+== Getting closer ==
+
+But in 2000, when Marco Trevisani proposed (this time to Nicola
+Bernardini, Gunter Geiger, Dave Phillips and Maurizio De Cecco) to
+build !DeMuDi (''Debian Multimedia Distribution'') an unofficial
+Debian-based binary distribution of sound/music Free Software,
+times were riper.
+
+Nicola Bernardini organized a workshop in Firenze, Italy at the
+beginning of June 2001, inviting an ever-growing group of supporters
+and contributors (including: Marco Trevisani, Gunter Geiger, Dave
+Phillips, Paul Davis, Francois Dechelle, Georg Greve, Stanko
+Juzbasic, Giampiero Salvi, Maurizio Umberto Puxeddu and Gabriel
+Maldonado). That was the occasion to start the first concrete !DeMuDi
+distribution, the venerable ''0.0 alpha'' which was then
+quickly assembled by Gunter Geiger with help from Marco Trevisani. A
+bootable CD-version was then burned just in time for the ICMC 2001
+held in La Habana, Cuba, where Gunter Geiger and Nicola Bernardini
+held a tutorial workshop showing features, uses and advantages of
+!DeMuDi.
+
+== AGNULA ==
+
+On November 26, 2001 the European Commission awarded the AGNULA
+Consortium - composed by the Centro Tempo Reale, IRCAM, the
+IUA-MTG at the Universitat Pompeu Fabra, the Free Software Foundation
+Europe, KTH and Red Hat France - with consistent funding for an
+accompanying measure lasting 24 months (IST-2001-34879). This
+accompanying measure, which was terminated on March 31st 2004, gave
+considerable thrust to the AGNULA/!DeMuDi project providing scientific
+applications previously unreleased in binary form and the possibility
+to pay professional personnel to work on the distribution.
+
+AGNULA has constituted a major step in the direction of creating a
+full-blown Free Software infrastructure devoted to audio, sound and
+music, but there's much more to it: it is the first example of a
+European-funded project to clearly specify the complete adherence of
+its results to the Free Software paradigm in the project contract,
+thus becoming an important precedent for similar projects in the
+future.
+
+== Voluntary project ==
+
+After the funded period, Media Innovation Unit, a component of Firenze
+Tecnologia (itself a technological agency of the Chamber of Commerce
+of Firenze) has decided to partly fund further AGNULA/!DeMuDi
+developments.
+
Added: demudi-trac/trunk/wiki/DownloadApt
===================================================================
--- demudi-trac/trunk/wiki/DownloadApt 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DownloadApt 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,28 @@
+= APT repository =
+
+APT is a system to install software from package repositories residing on
+various media (CD-ROMs, Internet sites, USB sticks, etc.). Read
+[http://www.linuxgazette.com/issue84/tougher.html here] if you are new
+to APT.
+
+If you want to download packages from the Internet insert the following lines
+in your {{{/etc/apt/sources.list}}} file:
+
+{{{
+
+ # Debian
+ deb http://ftp.debian.org/debian testing main
+ #deb-src http://apt.agnula.org/demudi testing local
+
+ # DeMuDi
+ deb http://apt.agnula.org/demudi testing local
+ #deb-src http://apt.agnula.org/demudi testing local
+
+}}}
+
+Note that the {{{deb-src}}} entries are only useful if you want to get the
+'''source code''' of the packages.
+
+Please check the Debian [http://www.debian.org/mirror/list mirror list] to
+find on in your country, or use '''apt-spy''' to automatically guess the
+fastest one.
Added: demudi-trac/trunk/wiki/DownloadCdRom
===================================================================
--- demudi-trac/trunk/wiki/DownloadCdRom 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/DownloadCdRom 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,15 @@
+= Download the installable CD-ROM image =
+
+Please read [wiki:DocsInstall here] '''before''' starting the installation.
+
+You can get the ISO image from one of the following sites:
+
+ * http://freesoftware.ircam.fr/mirrors/agnula/1.2/1.2.0/demudi_1.2.0_i386.iso
+ * http://ccrma.stanford.edu/mirrors/agnula/agnula-iso/1.2/1.2.0/demudi_1.2.0_i386.iso
+ * http://download.agnula.org/1.2/1.2.0/demudi_1.2.0_i386.iso
+
+A !BitTorrent stream for the !DeMuDi 1.2.0 iso can be found here:
+
+ * http://torrent1.youceff.com/download.php?file=460600&cat=&subref=
+
+It has one pretty fast and well connected seeder, at least in the evening/night (European time).
Added: demudi-trac/trunk/wiki/InstallApt
===================================================================
--- demudi-trac/trunk/wiki/InstallApt 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/InstallApt 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,28 @@
+= APT repository =
+
+APT is a system to install software from package repositories residing on
+various media (CD-ROMs, Internet sites, USB sticks, etc.). Read
+[http://www.linuxgazette.com/issue84/tougher.html here] if you are new
+to APT.
+
+If you want to download packages from the Internet insert the following lines
+in your {{{/etc/apt/sources.list}}} file:
+
+{{{
+
+ # Debian
+ deb http://ftp.debian.org/debian testing main
+ #deb-src http://apt.agnula.org/demudi testing local
+
+ # DeMuDi
+ deb http://apt.agnula.org/demudi testing local
+ #deb-src http://apt.agnula.org/demudi testing local
+
+}}}
+
+Note that the {{{deb-src}}} entries are only useful if you want to get the
+'''source code''' of the packages.
+
+Please check the Debian [http://www.debian.org/mirror/list mirror list] to
+find on in your country, or use '''apt-spy''' to automatically guess the
+fastest one.
Added: demudi-trac/trunk/wiki/InstallCdRom
===================================================================
--- demudi-trac/trunk/wiki/InstallCdRom 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/InstallCdRom 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,40 @@
+= How to install DeMuDi from CD-ROM =
+
+== About the installer ==
+
+The !DeMuDi CD-ROM installer is just a partially automated Debian installer.
+
+If you are new to the Debian installation system we recommend reading:
+
+ * [http://www.debian.org/CD/faq/ Frequently Asked Questions on Debian CDs]
+ * [http://d-i.alioth.debian.org/manual/en.i386/index.html Debian Full Installation Guide]
+
+== Download ==
+
+The latest !DeMuDi ISO image can be found here:
+
+ * http://freesoftware.ircam.fr/mirrors/agnula/1.2/1.2.0/demudi_1.2.0_i386.iso
+ * http://ccrma.stanford.edu/mirrors/agnula/agnula-iso/1.2/1.2.0/demudi_1.2.0_i386.iso
+ * http://download.agnula.org/1.2/1.2.0/demudi_1.2.0_i386.iso
+
+A !BitTorrent stream for the !DeMuDi 1.2.0 ISO is also available:
+
+ * http://torrent1.youceff.com/download.php?file=460600&cat=&subref=
+
+== Quick start ==
+
+For a quick start please follow these steps:
+
+ * Download the latest CD-ROM image
+ * [http://www.debian.org/CD/faq/#record-unix Record] it on a writable CD-ROM
+ * If necessary configure your machine to boot from the CD-ROM drive (this is the default on modern computers)
+ * Insert the CD-ROM in the reader and restart the machine
+ * Press enter at the prompt
+ * Select your language, nationality and keyboard
+ * [http://d-i.alioth.debian.org/manual/en.i386/ch06s03.html#di-partition Create a partition] for !DeMuDi
+ * Wait for the base system to be installed
+ * Check that all your operating systems are detected
+ * Eject the CD-ROM and reboot
+ * Configure your root password and user account
+ * Select the package sets you want to install
+
Added: demudi-trac/trunk/wiki/LinksAudio
===================================================================
--- demudi-trac/trunk/wiki/LinksAudio 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/LinksAudio 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,8 @@
+= Audio related links =
+
+ * [http://en.wikipedia.org/wiki/Low_latency Low latency]
+ * [http://www.zip.com.au/~akpm/linux/schedlat.html Linux scheduling latency]
+ * [http://www.linuxdj.com/audio/lad/resourceslatency.php3 LAD hints]
+ * [http://www.djcj.org/LAU/guide/Low_latency-Mini-HOWTO.php3 Low latency Mini HOWTO]
+ * [http://www.agnula.org/Members/tormod/compile-2.6/document_view How to compile the 2.6]
+ * [http://www.agnula.org/Members/tormod/kernel-2.4.27/document_view How to compile the 2.4]
Added: demudi-trac/trunk/wiki/LinksDebian
===================================================================
--- demudi-trac/trunk/wiki/LinksDebian 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/LinksDebian 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1 @@
+= Debian related links =
Added: demudi-trac/trunk/wiki/LinksLinux
===================================================================
--- demudi-trac/trunk/wiki/LinksLinux 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/LinksLinux 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,4 @@
+= Linux related links =
+
+ * [http://ultra.litpixel.com:82/links/linkmat.cgi Linux Links]
+ * [http://google.com/linux Linux Google]
Added: demudi-trac/trunk/wiki/WikiStart
===================================================================
--- demudi-trac/trunk/wiki/WikiStart 2004-11-03 21:14:52 UTC (rev 90)
+++ demudi-trac/trunk/wiki/WikiStart 2004-11-04 11:37:01 UTC (rev 91)
@@ -0,0 +1,35 @@
+= Welcome to AGNULA/DeMuDi =
+
+== What ==
+
+!DeMuDi is a [http://www.debian.org/ Debian] based GNU/Linux distribution
+focused on multimedia applications.
+
+!DeMuDi is '''not''' a different thing to Debian, it is just a
+[http://wiki.debian.net/index.cgi?CustomDebian custom] way to
+distribute it. Read more on the !DeMuDi concept [wiki:DocsConcept here].
+
+Currently the !DeMuDi mainly deals with
+[wiki:DocumentsSoftware sound and music software], but
+it will eventually include state of the art video tools too.
+
+== How ==
+
+To install !DeMuDi on the hard disk of your computer please read the
+[wiki:InstallCdRom CD-ROM installation] page.
+
+If you have already a running Debian system please refer to the
+[wiki:InstallApt APT setup] page.
+
+== Why ==
+
+!DeMuDi is a part of the [http://www.agnula.org AGNULA] project, whose goal
+(amongst others) is to help spreading sensibility on the topics of Free Software,
+with specific attention paid to audio/video applications and content distribution.
+
+== Who ==
+
+PEOPLE LINK
+
+The project is definitely community oriented and feedback is always
+welcome and taken into account.