Welcome to Gentoox!
The original Xbox adaptation of Gentoo

     Modules
· Home
· Buy_Gentoox
· Contact
· Dev_and_Sources
· Downloads
· FAQ
· Forums
· Links
· Magic_Repository
· Misc
· News Archive
· Patches
· Polls
· Search
· Sections
· Server_Stats
· Top 10
· Tutorials

     IRC

irc.shallax.com
#gentoox


     Search



     Donate

Donors will be listed HERE!

Donations are handled by paypal.com

Hardware donations are also welcome, email me using the contact form!


     Latest Versions
Prov5.1
Homev7.1
Loaderv6.07
MCEv1.3
Resctooxv6.0
Sparklev4.0

     Powered by


Pro v1.1

(1618 total words in this text)
(7657 reads)   Printer Friendly Page




Gentoox Pro v1.1b
---------------------

Copyright (C) Thomas "ShALLaX" Pedley (gentoox@shallax.com)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

----------------------------------------------------------------------

-0.5 - DISCLAIMER
0.0 - Preamble
0.1 - Whats new?
1.0 - Installation tips
1.1 - Necessary Configuration
1.2 - Extra tweakables
2.0 - Help, I'm still stuck!
2.1 - Q&A
2.2 - Known issues
3.0 - Plans for the future
4.0 - Thanks

-----------------

-0.5 DISCLAIMER

This Linux distribution contains no copyrighted Microsoft code, no hacked executables, no illegally compiled executables and no other illegal material to the best of my knowledge. If anything is later discovered to be illegal, when given reasonable proof, this distribution will be taken out of circulation and destroyed and you must do the same.

This software comes with absolutely no warranty and I will not be held liable for anything bad that comes of using it. I will not be held responsible for any losses incurred from using this software.

This software has the potential of ruining all the data stored on your Xbox including your TSOP or modchip. You use this software and any subsequent software downloaded by this program at your own risk.

PLEASE NOTE THAT THIS IS THE PRO VERSION, IT IS ASSUMED YOU ARE FAMILIAR WITH LINUX. THIS VERSION DOES NOT FEATURE ANY 'PRETTY' SCRIPTS TO HELP YOU MAINTAIN THE SYSTEM AND IT DOES NOT HAVE A PREINSTALLED GUI

-----------------

0.0 - Preamble

Gentoox is a highly optimised and highly refined Linux distribution for the Xbox which receives regular updates.

Your Gentoox system comes with two predefined users, their details are as follows:

User: root
Pass: xbox

User: gentoox
Pass: xbox

The 'root' user is known as a superuser and has control over everything and everyone's actions! For this reason is it very important that you change your passwords as soon as you log in!. To do this, open a console and type:

su -
[enter root password when asked]
passwd user_name
newpassword
newpassword-confirmation

The "su -" command instructs Linux to (s)witch(u)sers to root and use root's system environment.

Once again, I refuse to accept responsibility for anything bad that may come of using this software. While I try my absolute best to ensure that this software is stable and fit for use, I make absolutely no guarantees that it is. Use this totally at your own risk. This software contains no hacked code or code built with the Microsoft Xbox SDK (XDK).

Throughout this readme you will see the term "xbox_ip", this is simply the IP address assigned to your Xbox, e.g. 192.168.1.13


0.1 - Whats new?

The following is a list of new features which are included with Gentoox Pro v1.1.

* Kernel 2.4.22 + source.
* FatX Fixes, allows any user to access FatX drives.
* All non-Xfree related Magic patches available as of 07/12/2003 are preinstalled.
* JoyD.
* Fixed USE flags.
* Totally recompiled all software with new GlibC, and USE flags.
* Forcedeth, legal nvnet replacement driver.

Note that there is NO FOCUS SUPPORT in this version as the drivers caused major issues with the framebuffer suchas slowdown and Xfree incompatibility. This means that v1.4/1.5 Xboxes will have either garbled or no video output.


Network
---------

If you do not have DHCP, the following settings will be automatically assigned to you:

IP: 192.168.1.13
Broadcast: 192.168.1.255
Netmask: 255.255.255.0
Gateway: 192.168.1.1

Of course, you can change these settings yourself by following the Network tutorial on the site.


loadmonitor
--------------

You can add /bin/loadmonitor to root's crontab by running 'crontab -e' as root, then add the following line to the bottom of the file:

0,5,10,15,20,25,30,35,40,45,50,55 * * * * sh /bin/loadmonitor

This will regulate the fanspeed, LED pattern and Xbox temperature all from one script. I.e. if your system becomes too hot, this script will increase the fan speed until the temperature reaches a satisfactory level.

Also, this script will change the power LED pattern based on system load.

See inside /bin/loadmonitor for details and for customisation!


JoyD
-----

JoyD allows you to execute commands via the Xpad. Currently implemented combinations are:

Back + White = REBOOT
Back + Black = HALT

Note that this has nothing to do with EvoX IGR.

-----------------

1.0 - Installation tips

None of this section applies for 'native' installs. Do not attempt to run these commands if you have selected 'native' or you may damage your filesystem! These commands have been known to fail and may cause dataloss, use at your own risk!

If you later want to switch which partition Gentoox is installed to, you can do so by running the following commands:

1) Open a console
2) su -
3) [enter root password when asked]
4) magic f-drive << Puts Gentoox on F:
* OR
magic e-drive << Puts Gentoox on E:

Should you find yourself running out of space for Linux, you can either follow the online tutorial on resizing your rootfs, or you can run the following command to add more partitions (100-4000MB and as many as you can fit on F:)

magic newfs

Follow the on screen instructions for each of them. The e-drive and f-drive scripts have safeguards which wont allow you to run either one more than one time in succession.


1.1 - Necessary Configuration

You should run "xbvset" first thing to setup your video modes. Follow the onscreen instructions.


1.2 - Extra tweakables

Once you've got your resolution selected, you'll notice your LED is green while running and red while rebooting/ shutting down. You can change the colour sequence/ pattern by doing the following:

su -
[enter root password when asked]
blink

Have fun with this, but follow the instructions ;)

-----------------

2.0 - Help, I'm still stuck!

If you are having issues using the magic system, remember you can always run "magic usage" (provided you have an internet connection).

Your most valuable resource regarding Gentoox is its homesite: http://gentoox.shallax.com If you need some dynamic assistance, feel free to drop in to the official channel on irc:

Server : irc.shallax.com
Channel: #gentoox

( Windows mIRC users can run the following url: irc://irc.shallax.com/gentoox )


2.1 - Q&A

Q) Gentoox hangs whilst launching from EvoX... What do I do?!
A) Turn off In-Game-Reset (IGR) from EvoX. This needs to be disabled in ALL 3 places! This is a bug the EvoX team seem to have introduced in v1.8.3921. They tell me this will be fixed in the next release.

Q) I cant see anything when I boot up, what can I do?
A) You can edit linuxboot.cfg, you should see this line

video=xbox:800x600,nohwcursor,hoc=X,voc=Y

Basically, you can change the resolution here, and the horizontal (hoc) and vertical (voc) overscan correction. Tested resolutions are 640x480, "hoc" and "voc" are specified as percentages, (X and Y are defaults which are just ignored - they should work for everyone!). You can set these to hoc=10,voc=6, for example. The default settings _should_ work for everyone! XBV can be run on top of these settings should you wish to change your screen setup whilst linux is running.

The "nohwcursor" is what fixes the garbled cursor graphics.


2.2 - Known Issues

* Sometimes USB drivers may not be loaded correctly, just reset and it should fix the problem. If this happens, then obviously the JoyD combinations wont work!

-----------------

3.0 - Plans for the future

This isnt a final release, the following still needs to be done:

* 3D nVidia acceleration

Please dont contact me about progress on 3D acceleration, if it ever gets done, I'll tell you.

-----------------

4.0 - Thanks

Thanks goes out to everyone who has supported me, offered suggestions and criticised (constructively!!!) my work. You are the people who motivate me in my task to product (what I feel) is the best Xbox Linux distribution around! Without you, I probably would not have bothered going beyond the initial "FINAL" release (as the name would suggest, I didn't plan on releasing any updates, hehehe!).

Thanks to all donators, without you I'd never have got all the hardware I needed to develop Gentoox at a reasonable rate.

I'd also like to thank Xantium from Xbox-Scene for posting news relating to Gentoox.

Thanks to the Xbox-Linux team for Cromwell.

HUGE thanks to the creator of BusyBox - that is an amazing piece of work! Also, thanks to the creators of Slackware and Slothbox.

Thanks to Soundgarden for providing me with something to listen to :)

Special thanks to Halfbreed for the XFCE wallpaper and Rickz0rz for the KDE wallpaper. Also many thanks to everyone else who submitted wallpapers, even if they didn't make it in! (Trogdor, Darkmotion, indi, fafnir, eentelf, janten, Dantax, mansen, Dmack_901, Yavin, fuz, MikerhinosFR, Agent Orange, fuz, Anata, Rickz0rz and anyone else who I may have left off!).

Thanks to Hellimod, Pedro, Dave, Blake, tytyty, Disp, Byte, Xolution, Genlee, Pb, def, wik, Ziekke, Coolberg, nitra, h3inrich, Rocketeer, xboxmastr, Bucko, paulproteus, Xenia bioterror, Turdhat, Jester, CyKiller, bikr, mikegrb, milkpost, Psylenced, TJ, Weezle nath69uk, kickass, madskillz, fuz-(for clogging up the forums with junk! ;)), BeckyK, Iriez.

And THANKS to everyone else I've forgotten (Sorry! Your help and support was much appreciated!)

Thanks to you for taking the time to read this instruction manual!

Remember - feedback is the only way I'll know when there is a problem



- Thomas "ShALLaX" Pedley (gentoox@shallax.com)



[eof]
  

[ Back to Versions | Sections Index ]




Administration
Gentoox is distributed under the terms of the General Public License

Page Generation: 0.15 Seconds