CD-Tux Users Guide.
Wellcome To CD-Tux


Contents


Instalation
Configuration - Running cdtuxsetup
INSIDE CDTUX:
The Main Menu:
New Image
Saved Images
Blanking CD-RW's
Importing Multisession CD's

Instalation


If you downloaded the source file:
You will have to download and install the Freepascal Compiler, the RPM is probably the
easiest choice for this.
Then install the latest snapshot, following the directions on the FPC homepage
And finally install the ncrt unit, available on the fpc-contributed units page.
With all this completed unpack the archive in pretty much any directory and issue the
commands below:
su root
roots password here
ppc386 cdtux.pas
ppc386 cdtuxsetup.pas
mv * /usr/bin
exit
And whammo, cdtux is installed.

If you chose the compiled binaries:
You can just mv them to /usr/bin and your done.
This is the recommended method.

Configuration -Running cdtuxsetup:
First of all, neither cdtux nor cdtuxsetup can be run by anyone but root.
Attempting to do so will cause the program to advise you of as much and exit.
I have not tested it with the suid command, but it might work, however your on your own
if you try it.
Before you go any further you may have to recompile your kernel.
Don't freak out, Linux loves this, and it;s reall easy.
Step By Step:
cd /usr/src/linux
make menuconfig

In the program that comes up choose block devices. Select SCSI-Emulation from the list
Then deselect ide-atapi cdrom support.
Exit the submenu and in the main menu choose scsi device support.
Here add scsi-generic to the list
{Optional asuming you know the kernel reall well] Check that the other settings are nice
and cute
Exit and save
Now type:
make dep
make clean
make bzImage
cp ../arch/[Blah Blah, it will be last directory in make bzImage's output]/bzImage /boot/linux.scsi
cd /etc

Open lilo.conf in your favorite editor
Copy the image that loads linux above itself and change the following:
label=linux-scsi And the path =/boot/linux.scsi
If it contains a default setting you might want to change this too.
Save and exit,
type: lilo
If all went well you should see amongst others:
Added linus-scsi*[* Only if you made it default]
Reboot
Thats all there is too it.

When you are ready to configure cdtux type:
cdtuxsetup
Asuming you installed to /usr/bin and it is in your path. Otherwize you might need to
prepend the path you chose.

You will now be presented with a screen showing the copyright notice for cdtuxsetup.
After reading it, just press any key.
CD-Tux will begin by asking you for the paths to the client programs.
It is recommended you use find to get these beforehand as you will need the full path.
The Directory for image design is important !
If it exists all data in it will be destroyed.
It must have at least 650mb of free space, or your cd-size will be likewise limited
After the paths are completed, cdtuxsetup will attempt to scan your scsi busses for
your device settings
If all is well you will find the scsi designations in the main window (else the problem
is probably in the path you supplied for cdrecord.
Simply type them over in the bottom spaces provided.
Oh, and if you don't have a seperate cd-rom drive, enter the designations for the cd-writer twice, and cdtux will function as normal.
Who needs graphics hey ? I've never seen a gui-based frontend help you with this part.
Finally cdtuxsetup will show you your choices and ask you to confirm them. If you made a mistake say no. And you Will Have A Chance To Correct it
This is also a good time to point out that whenever you see a yes or no question it will default to no if you press anything but yes.

Inside CDTUX:


Ok now your ready try the program out. Type:
cdtux
Yet again you will be presented with a screen showing the copyright information.
Press any key AFTER READING IT.
This brings you to the main menu.
You simply press the key designated to the command in question.
We Will go into more detail on the choices later.
Right now you will probably want to to choose new-image.

New Image:

This will bring up a new window, it should be empty except for the list of commands. For now choose A to add a track to the image.
At The bottom a progress bar will indicate the percentage of cd-space used.
Now you can choose wether it is to be a data or audio track, choose data for now.
Since this is the first Data track you will now have the oppurtunity to make a bootable
disk, note this will only happen on the first track and only if it's data. To make a bootable disk you will need a boot image. You can get this easily enough from a bootably floppy by issuing the dd command.
CD-Tux will take care of the rest. Now you can select files to go on the track.
You will be in the topmost window, and by using the arrow keys you can navigate the files in the root directory, pressing enter on a selection will have one of the folowing results
If it's a directory cd-tux will change into that directory.
If it's a file you it will be added to the track.
Note: clicking on the * will copy all files in the directory onto your image.
The last two entries are your cd-writer and cd-rom devices. Entering
on them will bring up the cd's table of contents.
To read files of a cd it must be mounted. And you change to the directory it is mounted on.

If you want to remove a choice from the list press tab.
You will now be in the seccond window. Use the arrow keys to find the file you want.
And press the [Del] button. You will have a chance to confirm this.
If you are certain the file will be removed.
Pressing The Right Arrow will allow you to create directories.
Selecting A directory will change into it. All files you select while in
that directory will be written into that directory.
Press tab again to return to the top window.
In the bottom window you will see a list of the applicable commands.
When you are satisfied simply press escape.
You will also see the progress meter at the utter bottom.
Since this is a data track, you will now see mkisofs running on your screen
When it is finished press any key and you will return to the image editor.
There should now be an entry called Data1.trk.
The number indicates cd-track number, ie there will only be 1 track 1.
If you now choose to add a wav file as an Audio track it will be called Audio2.wav
Adding audio tracks is very simple, just choose audio from the Add track selection.
You will yet again go to the file selection screen.
This time only supported audio sources will be visible.
Select just one.
If you choose another, it will overwrite the previous selection. You should now see:
Data1.trk
Audio2.wav

Etc. When you are satisfied with your image press w, to write the disk.
You will Be prompted to confirm this, and have a 3 seccond chance after that to abort.
At this point you will also be asked if you want to do a test run first. I seriously recommend
it at least for the first few disks. You will also be shown cd-tux's
recommended writing speed. If you are satisfied say yes or otherwise you
can change it.


Thus you can see that writing your disks are very simple. Most data disks will only have one track. While Audio will usually have severall. Mixed mode is supported on the fly.
When you exit the image definition screen you will have a chance to save the image. Which brings us to the next part.

Using Saved Images

To use an image saved earlier choose B from the main menu. You can just write it again
Or you can choose to edit it first. This works exactly the same way as A new Image except that you will see your current tracks on the screen.
You will be asked wether cd-tux was used to define the image.
If it wasn't you will not be able to edit it.

Blanking CD-RW's


On the main menu you have the option to either blank an entire cd-rw or just the Table Of Contents.
The difference is pretty much time.

Importing Multisession Data


This will scan your cd-writer and obtain the nescacry information for adding
Therr are some pitfalls in this:
You must do this before you start creating your cd-image.
You cannot use it with saved images.
You can add only one data track to a multisession disk.

I want to thank you for using Cd-Tux. It is possible that your version is a developement version so some features may not work yet.
Check the website for the latest version.
Or better join the mailing list by sending
a blank e-mail to cdtux.join@datadictator.co.za and recieve notification of all updates, And support.