Initial import of the Amnuts 2.3.0 talker code.

COPYRIGHT

@@ -0,0 +1,74 @@
++-----------------------------------------------------------------------------+
+     COPYRIGHT - COPYRIGHT - COPYRIGHT - COPYRIGHT - COPYRIGHT - COPYRIGHT
+       Copyright information for Amnuts
++-----------------------------------------------------------------------------+
+
+Preamble
+--------
+
+On 2002-07-18, Neil Robertson announced in the USENET message
+with ID 1027006837.1806.0.nnrp-07.c2de0bc0@news.demon.co.uk
+posted to newgroups alt.talkers, alt.talkers.nuts, and
+alt.talkers.programming that he was now allowing all versions
+of his NUTS codes to optionally be distributed under the General
+Public License. For reference this mesage can be accessed at the URL:
+http://groups.google.com/groups?selm=1027006837.1806.0.nnrp-07.c2de0bc0%40news.demon.co.uk
+For further information on NUTS licensing see the file docs/nuts_copyright.
+
+
+Copyright Information for Amnuts code
+-------------------------------------
+
+Amnuts 2.3.0 A Unix Talk Server via Telnet
+Copyright (C) 1996-1996  Neil Robertson (Boltar) [NUTS]
+Copyright (C) 1997-2003  Andrew Collington (Andy) [Amnuts]
+Copyright (C) 1999-1999  Gordon Chiu (Ardant) [ident-daemon]
+
+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.
+
+Optionally, you can also redistribute it and/or modify it under the
+terms of the original Amnuts license as detailed later in this file.
+
+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
+
+
+Optional Original Copyright for Amnuts code
+-------------------------------------------
+
+The Amnuts code and files contain within the distribution are supplied
+as freeware and not public domain.  I retain the copyright for all files
+included with exception of: the ASCII picture files and any unmodified
+documentation written by Neil Robertson.  I will take legal action against
+anyone/company who is found selling the code for their own commercial
+advantage, though if anyone wishes to run a pay-to-use talker using the
+Amnuts code then they are welcome.  If you wish to distribute the original
+Amnuts code to anyone else this must be done with my express permission.
+
+You are free to modify the Amnuts code anyway you wish to suit your
+own needs and distribute that.  You must not alter the .version, or the
+version prompt when logging in so much that it does not refer to the code
+being based on Amnuts or that the code isn't 100% original.  You must
+also leave the credits from Neil and myself in the code (viewed by '.help
+credits'), and also the header information at the top of the source code.
+
+Although every care has been taken to produce a bug-free talker system,
+this distribution is supplied as-is and I cannot be held responsible
+for damages incurred through any use of the Amnuts code or any other
+associated files.  This copyright pertains to ANY version of Amnuts,
+documents, or web site.  If you have any problems with this copyright
+notice then you should not use the code at all.
+
+Andrew Collington
+September, 2001
+
++-----------------------------------------------------------------------------+

IMPORTANT

@@ -0,0 +1,54 @@
++-----------------------------------------------------------------------------+
+    IMPORTANT - IMPORTANT - IMPORTANT - IMPORTANT - IMPORTANT - IMPORTANT
+        Information for the running of a talker based on Amnuts
++-----------------------------------------------------------------------------+
+
+If you are installing this Amnuts version as a fresh talker, with no prior
+datafiles, then this document may be of interest to you.  I would advise that
+you read it, and the documents it points you to.  However, if you are going to 
+upgrade your existing talker, or are going to use this code as your base and 
+add bits from your existing talker, then it is vital you read this document and 
+the others before you make any changes.
+
+First off, support is only given through the websites, and not through private 
+email.  You can gain support through the main Amnuts website 
+(http://amnuts.talker.com/ or http://www.amnuts.org/), or if you are looking
+to submit bugs or get the latest updated files, then you can gain that through
+the developer's site (http://www.amnuts.net/).
+
+The main difference you will notice about this code and any of the previous
+releases is that Amnuts now comes in many different files.  This means that if
+you make changes to any one of the .c files then you don't have to recompile
+everything again - just that one file.  This means, however, that if you're a
+previous Amnuts programmer you may have to reacquaint yourself with the code,
+because all the functions are now in different places.  If you check out the
+prototypes.h file (in the includes directory) you'll notice all of the
+functions listed under whatever file they're located in.
+
+Compiling is now different.  You'll have to compile using the Makefile.
+More information can be found in the 'compiling' document, found in the 'docs'
+directory.  You should read the compiling document, and then have a look at the
+Makefile and familiarize yourself with it.
+
+The ident deamon needs to be run separately.  This is because it's a separate 
+program to the talker, compiled as its own executable.
+
+Remember to login initially with the username 'test' and the password 'test'.
+You should then create a user file for yourself (by logging in or using the 
+create command) and use the test character to promote yourself to the highest
+rank.  Then DELETE the test account so no one else can use it.  Alternatively,
+of course, you could login with Test, change the password, and then use the 
+name changing command. :)
+
+The *MOST* important thing to remember though is; RTFM!!  Read the
+documents supplied with the distribution, look at the code, try something
+out.. Only then if that fails should you go asking questions on boards and
+such.  It also helps if you give an example of what you've tried too.
+Bug reports I'm still up to receiving, but even then, don't be upset if
+you don't get a thorough response.
+
+
+                                                              Andrew Collington
+                                                    The Amnuts Development Team
+                                                                   August, 2003
++-----------------------------------------------------------------------------+

README

@@ -0,0 +1,46 @@
++-----------------------------------------------------------------------------+
+ README - README - README - README - README - README - README - README - README
+   Introductory information for the Unix talker code Amnuts
++-----------------------------------------------------------------------------+
+
+Welcome to the Amnuts talker code, version 2.3.0!  Or, if you have already
+used Amnuts, then welcome back!  This is the latest version of Amnuts and MANY
+things have changed.
+
+Amnuts development slowed down for a (long) while, but thanks to two people
+in particular, it managed to get back on track.  These people go by the handles
+'Ardant' and 'Uzume'.  Ardant supplied a CVS repository and bug tracking
+software for Amnuts, and Uzume and worked tirelessly in updating Amnuts and
+making it more stable.  Many thanks to both of them.
+
+Because of the CVS and Bugzilla, a new website was set up for the development
+of the Amnuts talker code.  This can be found at:
+
+   http://www.amnuts.net/
+
+Instructions can be found there on how to use CVS and Bugzilla.  If you find
+any bugs with this version of Amnuts then it would be appreciated if you use
+Bugzilla to report them.  From the CVS repository you can download the latest
+files.
+
+The Amnuts code can be found, as always, at:
+
+   http://amnuts.talker.com/
+
+or can now also be access via:
+
+   http://www.amnuts.org/
+
+Please read the 'IMPORTANT' file, and the 'amnuts_changes' in the DOCs
+directory for more information on what changes have been made since
+version 2.2.1 (the previous release to this one) because there have been a
+LOT of them!  Even if you are a previous Amnuts user, programmer, owner,
+whatever - you should STILL READ THE FILES! :)
+
+Thanks for using Amnuts!  Enjoy!
+
+
+                                                              Andrew Collington
+                                                    The Amnuts Development Team
+                                                                   August, 2003
++-----------------------------------------------------------------------------+

TODO

@@ -0,0 +1,27 @@
+Okay, the infamous TODO list...
+
+Get the ident code working properly (different host binaries)
+
+Add the pager code
+	- fix the 1-extra line bug
+
+New smail method - make sure to retro read the old smail version and convert
+	- failing that, write a perl script to do it which people will have to run
+
+New message board method - like smail
+
+Add new command 'stopcommand' (or whatever) to stop a command being used by
+anyone.
+
+Add a boxing feature using grab_len and center_string to box (and align) over multiple lines
+
+Move commands fully into linked list.
+	- save soundex codes in the linked list structure
+	- save status (on/off) of command
+	- save normal level of command
+	- save temp level of the command
+	- possibly save function pointer
+	- look into saving command states during reboot
+
+Use function pointers for commands ;)
+

datafiles/andys_computer.R

@@ -0,0 +1,6 @@
+Walking behind Andy you notice that he is hard at work programming and
+creating web pages.  He turns around and breathe a sigh of relief as he
+notices you're not the boss.  A few quick taps on the keyboard and the
+screen on his computer changes.  It's still a program and web page he's
+working on, but that sure as hell doesn't look like anything relating to
+what he's being paid for!

datafiles/back_store.R

@@ -0,0 +1,6 @@
+Thinking that no room could be colder than the store room you find
+yourself in a mild state of shock.  The spiders are skiing down the snow,
+the woodlice have been building snowmen and the flies are having a
+friendly snow ball fight.  Cold does not describe it.  Cold and Messy
+pretty much does though.
+

datafiles/box.R

@@ -0,0 +1,2 @@
+This is a box.  It does box things, like.. hold stuff.  It's not big, it's
+not clever and it's not worth describing in detail.

datafiles/car_park.R

@@ -0,0 +1,4 @@
+There is a wide expanse of concrete infront of you.  Somewhere in the
+distant, just on the end of your range of vision, you see... yes, it's a
+car.  You look up at the building beind you and wonder if it really needs
+a carpark this big with the few people who actually work in there.

datafiles/conference.R

@@ -0,0 +1,4 @@
+There is a musty smell here, and it is very cold.  You correctly guess
+that not many people use this room.  It's very plain, very boring.  You
+give up even looking at the room and fall asleep - well why not?  The boss
+isn't here afterall!

datafiles/config

@@ -0,0 +1,87 @@
+# Main config file for Amnuts
+
+INIT:
+verification       amnutsabc
+mainport           2402
+wizport            2403
+linkport           2404
+max_users          50
+max_clones         5
+heartbeat          2
+login_idle_time    180
+user_idle_time     3600
+time_out_afks      YES
+ban_swearing       OFF
+auto_connect       YES
+ignore_sigterm     NO
+system_logging     ON
+colour_def         ON
+prompt_def         OFF
+charecho_def       OFF
+passwordecho_def   OFF
+minlogin_level     NONE
+mesg_life          10
+mesg_check_time    01:00
+min_private        2
+ignore_mp_level    ARCH
+rem_user_maxlevel  SUPER
+rem_user_deflevel  USER
+wizport_level      WIZ
+gatecrash_level    GOD
+time_out_maxlevel  WIZ
+crash_action       NONE
+auto_purge         NO
+allow_recaps       YES
+auto_promote       NO
+personal_rooms     YES
+startup_room_parse YES
+random_motds       YES
+resolve_ip         AUTO
+flood_protect      ON
+boot_off_min       YES
+default_warp       reception
+default_jail       cupboard
+default_bank       safe
+default_shoot      directors
+
+
+ROOMS:
+# format
+# map  label  name         links              netlink connections
+general re  reception      cp,s1,mo,cu        PUB
+general cp  car_park       re                 PUB
+general s1  store_room     re,mo,s2,wr,cra
+general mo  main_office    re,s1,li,cr,to,dr  PUB
+general s2  back_store     s1,to,cr
+general li  library        mo,cr,ac
+general cr  conference     li,mo,s2
+general to  toilets        mo,s2
+general dr  directors      mo,sa              PUB
+general sa  safe           dr                 PUB  ACCEPT
+general wr  wizroom        s1                 PRIV
+general cu  cupboard       re                 PRIV
+general ac  andys_computer li                 PRIV
+store   cra crate          s1,box
+store   box box            cra
+
+TOPICS:
+# format
+# room name     topic
+reception       ~OLWELCOME!~RS
+library         Ssshhhhhh....
+directors       Let the slaughter begin!
+andys_computer  Thanks for using Amnuts :)
+
+
+# Link to the 2nd talker. You may need to put the machine name rather than
+# localhost here when you're running the 2nd talker on the same machine, it
+# depends on how the /etc/hosts file is set up and also the resolver.
+# none of these are real talkers or sites!
+
+SITES:
+# format
+# link name    address               password
+talker1        localhost 5002        test123
+darkroom       foo.bar.com 3456      Bloggs456
+myplace        11.11.11.11 7401      NotReal
+

datafiles/config2

@@ -0,0 +1,63 @@
+# This is the 2nd config file for you to use with a copy of the talker
+# to get 2 talkers linked together. A lot of parameters are missing here
+# in the INIT section to demonstrate the fact that you can leave them as
+# the software defaults.
+
+INIT:
+verification       test123
+mainport           5000
+wizport            5001
+linkport           5002
+max_users          50
+max_clones         5
+heartbeat          2
+login_idle_time    180
+user_idle_time     3600
+time_out_afks      YES
+ban_swearing       OFF
+auto_connect       YES
+ignore_sigterm     NO
+system_logging     ON
+colour_def         ON
+prompt_def         OFF
+charecho_def       OFF
+passwordecho_def   OFF
+minlogin_level     NONE
+mesg_life          10
+mesg_check_time    01:00
+min_private        2
+ignore_mp_level    ARCH
+rem_user_maxlevel  SUPER
+rem_user_deflevel  USER
+wizport_level      WIZ
+gatecrash_level    GOD
+time_out_maxlevel  WIZ
+crash_action       NONE
+auto_purge         NO
+allow_recaps       YES
+auto_promote       NO
+personal_rooms     YES
+startup_room_parse YES
+random_motds       YES
+resolve_ip         AUTO
+flood_protect      ON
+boot_off_min       YES
+default_warp       hallway
+default_jail       jail
+default_bank       lounge
+default_shoot      corridor
+
+
+ROOMS:
+general dr drive    ha        PUB  CONNECT talker1
+general ha hallway  dr,co,wz  PUB
+general wz wizroom  ha        PRIV
+general co corridor ha,lg
+general lg lounge   co        BOTH ACCEPT
+general ja jail     wz        PRIV
+
+
+# Link back to talker 1
+SITES:
+talker1       localhost 2404         amnutsabc
+

datafiles/crate.R

@@ -0,0 +1,4 @@
+The create you now sit in is so big it feels like a complete room.  But
+it's cold in here, and dark.  Oh, so dark...  You hear a noise and see
+something out of the corner of your eye scuttle across the floor of the
+crate.  Was that a rat?  No, just a very large spider!

datafiles/cupboard.R

@@ -0,0 +1,7 @@
+It's dark in here and as you enter you're sure someone locks the door
+behind you.  There is a faint sound of muffled laughter to be heard out
+side of this room.  To add torture to the experience of being jailed in
+the cupboard your boss has left you a 'to-do' list which they want
+completed.  A small tape-recorder activates automatically every so often;
+it's the boss, disturbing you and adding more items to your list just as
+you're trying to work through them...