home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 July / Chip_2004-07_cd1.bin / tema / aos / files / tos-readme.txt < prev    next >
Text File  |  2004-05-24  |  14KB  |  342 lines
  1. TriangleOS 0.0.3 - README
  2. ===========================
  3.  
  4. 0. Index
  5. =================================================
  6.     0. Index
  7.     1. Introduction
  8.     2. Compatibility
  9.         2.1 GUI (Graphical User Interface)
  10.         2.2 Networking
  11.         2.3 Mouse
  12.         2.4 Emulators (VMWare, Bochs, etc.)
  13.                 2.4.1 VMWare
  14.                 2.4.2 Bochs
  15.     3. Known problems/bugs
  16.     4. Installing TriangleOS
  17.     5. Starting and configuring TriangleOS
  18.         5.1 Boot
  19.         5.2 Configure TriangleOS
  20.             5.2.1 Networking
  21.             5.2.2 GUI
  22.                     5.2.2.1 Mouse
  23.         5.3 Logging in
  24.         5.4 Starting applications
  25.             5.4.1 Text mode
  26.             5.4.2 GUI
  27.     6. FAQ
  28.     7. Special Thanks
  29.     8. Bye
  30.  
  31. 1. Introduction
  32. =================================================
  33.  
  34. This is TriangleOS 0.0.3. This is the third release, and as usual, a lot of changes have been made since
  35. the previous version (0.0.2). A lot of bugs have been fixed and new features were added. However, this 
  36. is still no guarantee that T/OS is 100% bug free, so use at your own risk ;)
  37.  
  38. 1.1 These are the current features of TriangleOS:
  39. ------------------------------------------------
  40.  
  41. > 32-bit protected mode kernel for i386+ (paging, semaphores, critical sections, muteces, etc.) 
  42. > Virtual File System 
  43. > Kernel Modules 
  44. > Drivers 
  45.         > [Storage  ] Floppy Disk Driver 
  46.         > [Input    ] Keyboard Driver 
  47.         > [Input    ] Serial Mouse 
  48.         > [Input    ] PS/2 Mouse 
  49.         > [Output   ] PC Speaker
  50.         > [Output   ] Kernel Console 
  51.         > [Output   ] Virtual Consoles 
  52.         > [Output   ] Graphical 'text' Console
  53.         > [Graphics ] VBE2 (VESA2+) driver 
  54.         > [Network  ] NE2000 Driver
  55.         > [Network  ] RealTek 8139 Driver
  56. > Networking TCP/IP-Stack
  57.     > Ethernet
  58.     > IP
  59.     > ARP
  60.     > ICMP
  61.         > TCP
  62.     > UDP
  63.         > DHCP Client
  64.         > BSD Socket Interface
  65. > Triangle Graphical User Interface 
  66.     > Windows
  67.     > Buttons 
  68.     > Bitmaps
  69.     > Fonts
  70.         > Desktop
  71.         > Window Text
  72.         > Wallpaper
  73.         > Percent Bar
  74.         > ScrollBars
  75.         > MenuBar with menu and analog clock
  76.         > Input Bar
  77.         > TextField
  78.         > ListBox
  79.         > Screensaver
  80. > File Systems
  81.     > TriangleFS (for floppies)
  82.     > DevFS (Device Manager), SystemFS (Contains system information)
  83.     > Block Cache 
  84. > Multitasking (processes, threads). Very multithreaded.
  85. > User applications (COFF or ELF executable format). Compressed.
  86.     + Native
  87.         > Shell v1.3
  88.         > Process Viewer
  89.         > Bounce
  90.         > Change Password
  91.         > Network Setup program
  92.         > Ping
  93.         > Telnet
  94.         > Telnet Server
  95.         > HTTP Server
  96.         > Login
  97.         > Editor (GUI)
  98.         > CPU Meter (GUI) 
  99.         > Calculator (GUI)
  100.         > T/Eyes (GUI)
  101.         > User Control Panel (GUI)
  102.         > User list
  103.         > Application crash simulation test
  104.     + Ported
  105.                 > Chris Giese's Tetris 
  106.                 > Dirk Verhagen's Breakout
  107.                 > Chris Giese's ANSI Invaders
  108.                 > grdc (Graphic Digital Clock)
  109.                 > sl (Steam Locomotive)
  110.                 > fortune
  111.                 > figlet
  112.                 > piano
  113. > Libraries
  114.     > Fairly complete LIBC
  115.         > Networking Library (including BSD Socket Library)
  116.     > Curses for TriangleOS
  117.         > Graphical User Interface-library.
  118. > Virtual 86 Mode (VM86)
  119. > Default protected mode functions (paging, protection, etc.) 
  120.  
  121. For a list of changes since the previous version of T/OS, see the changelog.
  122.  
  123. 2. Compatibility
  124. =================================================
  125.  
  126. TriangleOS should work on all x86 PC's (386 and above). 
  127.  
  128. 2.1 GUI (Graphical User Interface)
  129. ------------------------------------------------
  130. To use the GUI you need a VESA 2.0 compatible video card. Most of the recent 
  131. video cards support this. You may select a resolution from 640x480x15bpp up 
  132. to 1280x1024x32bpp but since the video driver just uses VESA, using no 
  133. hardware acceleration whatsoever, don't be surprised if some video modes 
  134. are somewhat slow.
  135.  
  136. 2.2 Networking
  137. ------------------------------------------------
  138. TriangleOS supports NE2000 (PCI/ISA) compatible cards (such as the Winbond 89C940, 
  139. RealTek 8029, etc.) and the RealTek 8139 PCI Family. Without these cards you'll
  140. only have the loopback interface ;)
  141.  
  142. 2.3 Mouse
  143. ------------------------------------------------
  144. All PS/2 and serial mice should work OK. Please note that there's no USB-support yet.
  145. So if you use a USB port, you'll have to connect it to the PS/2 port to be able
  146. to use it.
  147.  
  148. 2.4 Emulators (VMWare, Bochs, etc.)
  149. ------------------------------------------------
  150.  
  151. It's best to run TriangleOS on a real PC, without using an emulator. You don't have to install
  152. TriangleOS, just create a TriangleOS boot floppy and start from it.
  153.  
  154.         2.4.1 VMWare
  155.         ------------------------------------------------
  156.         I have no idea if T/OS will run with VMWare. I don't have VMWare here
  157.         so there's no way for me to test this. I do know however, that last
  158.         time I checked VMWare did not support VESA2 with LFB and I don't think it'll
  159.         support a RealTek8139 or NE2000 network interface either, so I don't
  160.         think you'll be able to run it under VMWare. Also, VMWare's floppy
  161.         emulation is, like Bochs', very slow.
  162.         
  163.         2.4.2 Bochs
  164.         ------------------------------------------------
  165.         Like VMWare, Bochs does not support VESA2 or a RealTek or NE2000 network
  166.         interface (at least, my version doesn't, I'm not sure about the newest
  167.         versions). Also note that the floppy emulation for Bochs is _VERY_ slow.
  168.         Please keep in mind that the main goal of my OS is not to be compatible 
  169.         with emulators, but to be compatible with _real_ PC's. 
  170.  
  171. 3. Known problems/bugs
  172. =================================================
  173.  
  174. At this moment there are no real major bugs I know of, except for some small rendering
  175. glitches in the GUI. Also, the TCP/IP stack still needs some work (e.g. the anti-SYN-flood
  176. code is not done yet). If you detect a bug, please e-mail me about it so I can try and fix it.
  177.  
  178. 4. Installing TriangleOS
  179. =================================================
  180.  
  181. There's no need to install TriangleOS. You can copy it to a
  182. floppy and boot from it. You don't have to touch your harddisks.
  183.  
  184. 1 - Download the .ZIP file from the TriangleOS site.
  185. 2 - Unpack the .ZIP file. You now have the file tos-0.0.3-RELEASE.img
  186.     which is exactly 1.44MB (the size of a floppy).
  187. 3 - Write the image directly to the floppy using a tool like 'rawrite' 
  188.     or 'dd'. If you are using Windows, you can find a link to Rawrite
  189.     for Windows on my 'Links' page. If you use 'dd', type: 
  190.     dd if=tos-0.0.3-RELEASE.img of=/dev/fd0. 
  191. 4 - Reboot the computer with the floppy in the floppy drive.    
  192.  
  193. 5. Starting and configuring TriangleOS
  194. =================================================
  195.  
  196. 5.1 Boot
  197. ------------------------------------------------
  198.  
  199. To boot TriangleOS, just insert the floppy you just created by writing the 
  200. image to the floppy and reboot. The computer should boot from the disk. 
  201. TriangleOS will load the kernel and after that you should see a percent bar, 
  202. indicating it's starting. 
  203.  
  204. 5.2 Configure TriangleOS
  205. ------------------------------------------------
  206.  
  207. 5.2.1 Networking
  208. ------------------------------------------------
  209.  
  210. When the kernel is booted, and a network card has been detected (you need
  211. a NE2000-compatible or RealTek8139 network card, see 'Compatibility') the
  212. network setup program is started. Here you can set up your network interfaces
  213. by either entering the addresses manually or using DHCP.
  214. If you want to change your network settings later on, start /floppy/network.app
  215.  
  216. The default hostname is `deuterium'. You can change this with the same network
  217. setup program (/floppy/network.app). /floppy/network.app -h myhost changes the
  218. hostname to `myhost'.
  219.  
  220. 5.2.2 GUI
  221. ------------------------------------------------
  222.  
  223. Now you can select which environment you wish to use: Text Mode or the Graphical User Interface. 
  224. If you select Text Mode and want to use the GUI later on, go to the Debug Console (by pressing
  225. ALT-F10 and enter "gui").
  226.  
  227.         5.2.2.1 Mouse
  228.         ------------------------------------------------
  229.         If you selected the GUI, you have to select the mouse type that's connected
  230.         to your system. If you're not sure, select 'Autodetect'.
  231.  
  232. 5.3 Logging in
  233. ------------------------------------------------
  234. Whether you use the GUI or Text Mode interface, you have to login first. When prompted
  235. for a login name and password, use the user 'admin' with password 'admin'.
  236.  
  237. When you're telnetting to a TriangleOS server, you can't login with 'admin'. You need to create
  238. a normal user first, using either /floppy/chpass.app or using the 'Users' control panel
  239. in the GUI.
  240.  
  241. 5.4 Starting applications
  242. ------------------------------------------------
  243.  
  244. 5.4.1 Text mode
  245. ------------------------------------------------
  246.  
  247. TriangleOS will load the shell program on the virtual consoles 2 to 8. You can switch between consoles 
  248. by pressing ALT-Fx, where x is the corresponding number of the console. After the shells are started, 
  249. console 1 contains the Kernel Statistics, console 10 the Kernel Debug console and the login programs
  250. are started on the other consoles. So, pressing ALT-F1 shows the kernel statistics, ALT-F2 to ALT-F9
  251. the login screens, and ALT-F10 the debug console. If the GUI is active, you can switch to it by
  252. pressing ALT-F12. 
  253.  
  254. After you log in (See 5.3 Logging in) you can run programs or invoke other shell
  255. commands. To get a list of shell commands, type 'help'. All applications are located in the directory
  256. /floppy. So, if you want to start an application named "example.app", change the current directory
  257. to /floppy by typing `cd /floppy'. Now run the application by typing its name ('example.app'). 
  258. Note: you may omit the .app when starting applications. Of course you can also start the program
  259. without changing the directory first by typing its full path instead (/floppy/example.app).
  260.  
  261. To get a list of all files in the current directory, type 'ls'. Directories are green, symbolic
  262. links blue, applications you can start are red and objects are pink. If there are too many files
  263. to fit onto one screen, use 'ls /p'.
  264.  
  265. Again, for more shell commands type 'help' on the shell prompt.
  266.  
  267. 5.4.2 GUI
  268. ------------------------------------------------
  269.  
  270. After selecting "Graphical User Interface" you may select a resolution. Note: this list is NOT 
  271. a list of SUPPORTED modes. It's just a list of modes that the user is able to select. 
  272. After choosing a resolution, TriangleOS will try to switch to it. If your video card does 
  273. not support it, you can select another mode. After the GUI is started, you have to log in
  274. (See 5.3 Logging in). After logging in, you see the desktop and the menubar. You can launch
  275. programs via the menu, which is shown by pressing on the Triangle Button on the Menubar.
  276.  
  277. You can also view the system status by clicking the 'System' button in the menu.
  278.  
  279. 6. FAQ
  280. =================================================
  281.  
  282. Q: TriangleOS doesn't boot. What's wrong?
  283. A: If you get errors such as 'error reading disk' make sure your floppy is OK. I've had a lot
  284.    of experience with floppies and they tend to break quickly ;)
  285.  
  286. Q: Whooah, a login prompt. What's the password?
  287. A: Try user 'admin' with password 'admin'.
  288.  
  289. Q: If I use network applications like ping or telnet, using the name of the host doesn't work
  290.    but the IP does. e.g. ping www.google.com doesn't work, but ping 216.239.37.99 does.   
  291. A: Converting names to IP addresses is done by a DNS service. I have not yet written DNS support
  292.    for TriangleOS. Therefore you can't use hostnames yet.
  293.    
  294. Q: I'm sure my card is VESA2 compatible, but the GUI still doesn't work.
  295. A: Your card also has to support LFB (Linear Frame Buffer).
  296.  
  297. Q: What graphics cards are supported?
  298. A: All VESA2 compatible cards with LFB support. Almost every recent videocard supports this. 
  299.    (e.g. testing machines here have a GeForce2 MX400 and a S3 Virge 86C375).
  300.    
  301. Q: What network cards are supported?
  302. A: NE2000 compatible and RealTek8139 network cards are supported. TriangleOS lists these
  303.    cards as ed and rl resp. Loopback device is listed as lo.
  304.    
  305. Q: Does TriangleOS support DHCP?
  306. A: Yes, a built-in DHCP client is included.
  307.  
  308. Q: My videocard is very fast, yet I think the GUI should be able to be a lot faster.
  309. A: The disadvantage of using a VESA2 driver is that it doesn't use any hardware acceleration
  310.    of your videocard. I haven't had the time to write drivers for all kinds of different video
  311.    cards, though they may be added later.
  312.    
  313. Q: My USB mouse doesn't work. What's wrong?
  314. A: USB mice are not supported yet. Use a PS/2 or Serial Mouse, or use a convertor to insert your
  315.    USB mouse in the PS/2 port.   
  316.  
  317. Q: Is there any more software available for TriangleOS?
  318. A: At the moment, no. All available applications (except for some ported ones) are included on the
  319.    floppy disk. However more applications will be added. For example, I'm still planning on eventually
  320.    writing a Web Browser, E-Mail client and a MP3-player for TriangleOS.
  321.    
  322. Q: .... some other question
  323. A: See the other text in this readme.txt or e-mail me.
  324.  
  325. 7. Special Thanks
  326. =================================================
  327. to Kevin Cools, for making the icons/images shown in the Status Bar 
  328.    (not the ugly ones, I made those myself :P) and the lay-out of the website.
  329. to Koen Rutten, for the "popcorn" speaker test.
  330. to Olef van de Stadt, for trying very hard to crash every version of T/OS ;)
  331. to all the other DJOE members, for beta testing and always giving me ("constructive") critics ;)
  332. to Chris Giese, for letting me port his tetris and invader game.
  333. to Dirk Verhagen, for letting me include his breakout killer app ;) in this package.
  334.  
  335. 8. Bye
  336. =================================================
  337.  
  338. Have fun ;)
  339. For bugs, questions, etc. please mail to w.cools [AT] chello [DOT] nl
  340. TriangleOS (C) Copyright 2001,2002,2003 by Wim Cools
  341. Last updated 29/04/2003 23:59 GMT+1
  342.