GG-Lite-bin-m68k 1.0

Short:        Compact Developer Environment (binaries)
Author:       Geek Gadgets team and others
Uploader:     megacz usa com
Type:         dev/gg
Version:      1.0
Requires:     Amiga
Architecture: m68k-amigaos

GG-Lite-1.0 (m68k Amiga release)
---------------------------------

---

Geek Gadgets Lite was initially created as a compact  GNU CC environment to
help Amiga fans start coding in  C programming language. The main advantage
of the  package is that you do  not need to install  anything, nor you need
to have super-extra  OS installation. All it takes is just a  Workbench 3.x
floppy disk and around  70  megabytes of storage if whole package  is to be
installed. Less(apx. 30 megabytes) is needed if you want just the compiler.
Although  package is really aimed at being used with  'qdev'  so that quick
and easy,  native software  development is possbile it does not contain it!
The reason for that is  'qdev'  is still under heavy development  plus does
not really requires you to install it. This is because per branch  isolated
usage is essentially possible.

Geek Gadgets Lite consists of  3  archives where the  very first one is the
most important:

  GG-Lite-1.0-bin-m68k.lha - Base archive that contains minimalistic GNU CC
                             and friends(including headers and libs).
                             ----------------------------------------------
                             AmiTCP-SDK-4.3.lha
                             apurify_v1.5.lha
                             binutils-2.7-bin.lha
                             CGraphX-DevKit.lha
                             diffutils-2.7-bin.tgz
                             fd2pragma.lha
                             fileutils-4.0-bin.tgz
                             findutils-4.1-bin.tgz
                             gcc-2.95.3-4-bin.tgz
                             GccFindHit-1.2.1-bin.tgz
                             gdb-4.16-bin.tgz
                             guigfxlib.lha
                             gzip-1.2.4-bin.tgz
                             hackyheaders.lha
                             hunk2aout-2.0-bin.tgz
                             ixemul-48.3-bin-m68k.lha
                             KingCON_1.3.lha
                             lha-2.1.lha
                             libamiga-bin.tgz
                             libm-5.4-bin.tgz
                             libnix-2.0-bin.tgz
                             make-3.81-bin-m68k.lha
                             MMULib.lha
                             nano-1.2.5-bin-m68k.lha
                             NDK39.lha
                             pdksh-5.2.12-bin.tgz
                             PhxAss.lha
                             pth-2.0.7-2-bin-m68k.lha
                             renderlib.lha
                             sh-utils-1.16-bin.tgz
                             tar-1.12-bin.tgz
                             textutils-1.22-bin.tgz

  GG-Lite-1.0-doc-m68k.lha - Reference  manuals of all programs, tutorials,
                             examples, NDK and reader binaries.
                             ----------------------------------------------
                             gcc-faq_0.7.lha
                             groff-1.11a-bin.tgz
                             less-321-bin.tgz
                             manutils-2.1-bin.tgz
                             <...>

  GG-Lite-1.0-net-m68k.lha - AmiTCP  3.0b2  release prepared to work out of
                             the box with minimal alterations necessary.
                             ----------------------------------------------
                             3c589.lha
                             AmiTCP-bin-30b2.lha
                             CardPatch.lha
                             CardReset.lha
                             cnetdevice.lha
                             lynx-2.8.7-bin-m68k.lha
                             nicfeed.lha

As you can see "lastest-version-is-not-always-the-best" route was taken. It
is not  only bacause of this, but simply there is no newer packages around.
But anyway if you are experienced user and your knowledge on Amiga stuff is
excellent then you can  skip on documentation, also if you do not have home
network nor access to the  Internet  then the  last package can be ommitted
too. Note  however that having a functional loop interface  is a good thing
in general, so it is worth  to  install  the network stack and disable  all
physical interfaces.

To install the environment just download all the packages,  unpack them and
move the contents from  '#?-doc-#?' and '#?-net-#?' to '#?-bin-#?'. You are
done at this point. Now visit the 'GG-Lite-?.?-bin-m68k/GG/' from Workbench
and double click  'GG_Shell'. Korn shell prompt should show up. Compiler is
all ready at that time  and you can  start coding with  'nano'  text editor
which is a very intuitive thing :-) . If network is needed then please edit
the   'startnet'  script and specify your ADDR(an IP address of your Amiga)
and GATEWAY(address of your router or computer that does the NAT). You will
also  need to select network  interface that is  under IFACE. Included  are
Ethernet PCMCIA most popular drivers plus the default A2065 ZorroII driver.
If your  NIC  is not supported by this small subset then install the driver
in  'Devs/Networks'  and add proper entry in 'db/interfaces' and go back to
'startnet'.

Last update: 6-Jan-2013

---

NOTES:

[*]
Requires 68020(no FPU)+, OS 3.0+, 8+ MiB of free memory, Workbench 3.x disk

[*]
Very important! If you are 68040/68060 turbo board user and you do not have
support library in 'Libs:' then do something like this,

  cd GG-Lite-?.?-bin-m68k/
  copy Libs/mmu.library Libs:
  copy Libs/680??.library Libs:
  copy Devs/MMU-Configuration Devs:

and reboot asap. This will make sure that the  CPU  features and its caches
are being used properly. Without this your system will be unstable!

[*]
Please do not copy all other  OS components from  'Libs',  'Devs', 'L'  and
'Prefs' to your 'SYS:' partition they will be assigned automatically during
'gg_init'!

[*]
Please note that  OS/Workbench 2.x  boot  diskette is  unsuitable!  Package
programs  will most likely  crash  probably due to differences in  MathIEEE
libraries! In theory you could load V38 libraries residently and reboot and
it should work but i did not test that!

[*]
All the  'proto/' and  'inline/' were regenerated with 'fd2pragma' tool for
GCC so that no  'libamiga.a' glue is necessary, but all direct 'alib' calls
will reference that library!

[*]
If you need network then please edit 'BIN:startnet' script and fill in your
details. By  default no physical interface is to be put  online so only the
'lo0'  will be active. Remeber that if the  TCP/IP  stack is running before
you 'gg_init' then no GG-Lite network will ever be configured!

[*]
For your convinience '#?-net-#?' includes 'lynx' web browser so you can get
things from Internet as well as browse locally stored web sites.

[*]
Default DNS server can be found in  'db/netdb'  under NAMESERVER specifier.
If  you experience  problems with  Level 3 - 4.2.2.2  then try  the  Google
- 8.8.8.8 one.

[*]
No wireless  network cards are supported because  'prism2.device'  is still
too unstable. If  you  desperately  need  WLAN  then disable  'nicfeed'  in
'startnet'  so that the driver(it really  does not like to  be put offline)
will not crash your machine that soon...

[*]
When in doubt use 'multiview' or 'man' to get help. All the programs in the
archive come with the documentation.

[*]
Please  note that packages utilised  were copied minimalistically, which is
to say only the essential parts were taken! All the sources can be found on
the net.

[*]
Be aware that most GG programs accept UNIX-like paths, so 'RAM:' should  be
written as '/RAM/', also Amiga denesting '/' must be typed as  '../'. Local
files should be requested with './<file>'.

[*]
If you can put your hands on an  "Amiga Developer CD 2.1" then you are home
and  the Amiga development will no  longer be  heavy wizardy to you. Try to
Google, CD images are floating around.

[*]
As to binaries, startup codes and static link libraries 68020 flavours rule
the package. The  'libpthread.a'  library is the  HSCM  one so you can code
with no worries about context switches.

[*]
In the  '#?-doc-#?' archive aside reference manuals you will also find some
nice tutorials regarding GCC and GDB.

[*]
Aside 'nano' which was rebuilt to work on non-FPU setup there is also 'ame'
a GUI based MicroEmacs clone taken from DiceC package.

[*]
Feel free to hack on this package  and try to make it even  smaller if that
is possible at all. But  please maintain  full functionality! At  this time
all  the dependencies are met so i have no idea, beside  binary compression
which i  want to avoid  how to  make it smaller. Anyway,  if you  see  that
something can be done better please tell me about it. Thanks!

---

LINKS:

  http://aminet.net/                     Biggest Amiga software repository.
  http://cd.textfiles.com/               All rare  CD ISOs  are just there.
  http://bombjack.org/commodore/         Lots  of scanned  books  and mags.
  http://amiga-stuff.com/                Old  Amiga software site and more.
  http://mways.co.uk/amiga/              Nice set  of tutorials  on coding.
  http://w3.norman-interactive.com/      German fan site devoted to coding.
  http://www.amigacoding.com/            Lots  of  informational  material.
  http://www.amigacoding.de/             Amiga  Development  Info   Center.
  http://sf.net/directory/os:amigaos/    Free/open source  Amiga  projects.
  http://codewiz.org/projects/amiga/     Amiga  Freeware  Productions site.
  http://back2roots.org/                 Your one stop for oldschool stuff. 
  http://planetemu.net/                  Emulators,  tools  and  the  like.
  http://www.faqs.org/faqs/amiga/        Certain  FAQs on Amiga and coding.
  http://groups.google.com/              Google remebers the good old days.
  http://oldwww.nvg.ntnu.no/amiga/       Old  Amiga-FAQ  by  Ignaz  Keller.
  http://amiga.org/                      Amiga community portal and forums.

---

USAGE:

  ; Amiga shell use (do not forget about the stack!)
  cd GG-Lite-?.?-bin-m68k/GG/
  execute gg_init
  changetaskpri -10
  stack 131072
  cd home:
  gcc -g -m68020-60 -Wall hello.c -o hello
  hello

  ; Enter the debugger to sniff on the program flow
  gdb hello

  ; Edit the source code with 'nano' con text editor
  nano hello.c

---
megacz