AminetAminet
Search:
84450 packages online
About
Recent
Browse
Search
Upload
Setup
Services

comm/net/AMarquee.lha

Mirror:Random
Showing:i386-arosgeneric
No screenshot available
Short:V54.0 TCP Data Broadcast System (library & server)
Author:hakan at parting.nu (Håkan Parting & Jeremy Friesner)
Uploader:hakan parting nu (Håkan Parting)
Type:comm/net
Version:54.0
Requires:Workbench 2.04+, AmiTCP3.0b+ or compatible TCP stack
Architecture:m68k-amigaos
Date:2002-05-05
Download:http://aminet.net/comm/net/AMarquee.lha - View contents
Readme:http://aminet.net/comm/net/AMarquee.readme
Downloads:9638

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

						  AMARQUEE v54.0

					(Released May 4th 2002)

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


The Problem: 

 You have a great idea for a killer multi-player Internet game 
 or multi-user net app, but it's a total pain in the  at )#$* to 
 write all the TCP connection and data synchronization code 
 you'll need to get it going.  So you put your idea on the 
 back-burner and go play "Lemmings" instead.  And thus the 
 Amiga is deprived of a fun Internet app.  D-oh!  :(
 
The Solution:  (well, okay, it's *a* solution, anyway)

 AMarquee is a system that handles all of the icky information 
 distribution details for you, allowing you to concentrate on 
 coding your application, rather than on which data goes into 
 which socket when.  AMarquee consists of a shared library and
 a TCP daemon, which work together to get your data where it
 needs to be.  Your program calls simple amarquee.library
 functions to broadcast your data, and waits on a provided
 MsgPort for data from other hosts.  Easy!

 Version 49+ of amarquee.library may be used in more serious network
 applications too, that cannot use the amarquee protocol, like FTP and HTTP
 clients. This in the same easy fashioned way!

Features of amarquee.library (the shared library/API):

 - Programs written to use amarquee.library will work transparently
   with Inet225, AmiTCP, Miami, or any other TCP stack that is 
   "AmiTCP compatible".
 - Has a simple API that requires no knowledge of multithreading 
   techniques or socket programming to use.
 - Each AMarquee connection you make automatically and transparently
   starts a separate background execution thread, so your app will 
   never have to block while data is sent or received.
 - An arbitrary number of AMarquee connections may be active at once.
 - Allows you to "subscribe" to data that interests you, so that
   when the data on the server is changed you will be automatically 
   notified.  You never need to poll for anything!
 - An easy mechanism for sending messages to one or many other
   AMarquee clients that are logged into the same server.
 - Standard Amiga wildcarding is supported in all applicable functions.
   This allows you to easily and succinctly refer to one host or data
   item, or many, as appropriate.
 - #includes for C, C++, and PCQ Pascal are included.
 - ARexx accessible.  That is, ARexx scripts can use amarquee.library
   through rexxamarquee.library for communications using the same API
   that compiled C programs do.
 - Example programs in C, C++, Pascal, and ARexx are included.
 - Operation is almost totally asynchronous for efficiency, but
   several easy synchronization methods are available if you need them.
 - Can also be used for direct client-to-client connections and
   for making inetd-launched or manually-launched daemon programs.
 - Automatically detects when the computer on the other end of
   the AMarquee connection has crashed or been shut down, even 
   on idle connections.
 - In addition it can connect to any TCP service, eg. HTTP and FTP, and it will
   work in the same easy fashion like any other AMarquee connection.

Features of AMarqueed (the AmiTCP server):

 - Works with Inet225, AmiTCP, Miami, or any other TCP stack 
   that is "AmiTCP compatible".
 - Fully multithreaded design, with one server process per connection.
 - Re-entrant code, to minimize memory usage.
 - Data is stored in a filesystem-like tree structure for simplicity,
   flexibility and efficiency.  Each client gets its own "home directory"
   that it may write to or read from, and each client may also
   read from the "home directories" of other clients.
 - Efficient design minimizes CPU usage, net bandwidth, and execution time.
 - Limits may be put on memory usage, number of connections, and/or 
   which clients or apps may connect.  Only serve the hosts and apps
   you want to serve!
 - Supports data streaming to one or many clients at once.
 - Data streaming and synchronization features let you be sure your 
   data was read by all interested hosts before you update it again.
 - Automatically detects and eliminates "dead" connections (e.g.
   if the client computer was shut down without quitting politely)
 - Server may be administered remotely by clients with "privileged"
   status.

WHAT'S NEW IN VERSION 54.0:
( "-" = new feature, "*" = bug fix)
V54.0: (Public release 2002-May-04) (amarquee.library v54.0,
rexxamarquee.library v54.0, AMarqueed v51.0)
*    QGetLocalIP() did not return the local ip address when the session was
created with
	 QNewSocketServerSession().
*    When a session created with QNewHostSession is connected it shall return
the ip address
	 of the remote host in the qm_Data field of the QMessage, it did return the
local ip address
	 with version 53 of amarquee.library. So if your program doesn't work with v.53
you know why.
*    The version string of rexxamarquee.library wasn't updated since v 52.

V53.0: (Public release 2002-Apr-24) (amarquee.library v53.0,
rexxamarquee.library v53.0, AMarqueed v51.0)
-    New function STRPTR QGetLocalIP(struct QSession *)
	 It returns the local ip address of the interface that is connected to the
session.
	 Valid as soon as the session is connected.
*    The documentation for QNewSessionAsync() said that your hostname would be
	 returned in the qm_Path when your are connected to the server. That's not
true.
	 It will be /serverhostname/yourprogname
*    The datatype for argument two and three for the function QSetKeyAccessOp
was wrong in the AMarquee_protos.h.
-    Added QGetHostName, QGetProgName and QGetLocalIP to the
rexxamarquee.library.

V52.2: () (amarquee.library v52.0, rexxamarquee.library v52.0, AMarqueed v51.0)
-    The include files were modified. Added support for more compilers in the
pragma, clib
	 and proto files. Just copy over all of them to your include directories.

V52.1: () (amarquee.library v52.0, rexxamarquee.library v52.0, AMarqueed v51.0)
-    Added a unit for the FPC Pascal Compiler, and an example named
AMarqueeTest.pas.
	 The AMarquee.i file for PCQ Pascal was also updated with varargs functions for
the
	 new Tag-functions. The PCQ example named PascalTest.p was also updated to use
a Tag-
	 function.
	 All those files were kindly given to me by Nils Sjöholm, author of the PCQ
and the
	 Amiga port of FPC.

V52.0: (Public release 12-Aug-2000) (amarquee.library v52.0,
rexxamarquee.library v52.0, AMarqueed v51.0)
*    This bug should have been fixed in v.51 but apperently wasn't :(
	 The QNew*Session() and QFreeSession() functions cleared the shared message
port given
	 with the tag QSESSION_SHAREDMSGPORT.
	 Because of this misfunction there were problems when you created a new or
freed an old
	 session while there were messages waiting in the message port. You should
require at
	 least v.52 of amarquee.library when you use shared message ports.
	 Please understand that only one task, the one which created the shared message
port, may
	 create and free sessions which are bound to the shared message port.

	 For any sessions please also understand that you must make sure that only one
task at
	 one time use a specific session. This apply to all the Q*Op() functions, which
could be
	 called from several tasks if the calls are serialized.
	 QFreeSession() may only be called from the task which owns the session, i.e.
the task
	 which created the session or have taken over a session with
QReattachSession().


Contents of comm/net/AMarquee.lha
 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1357    4008  33.9% -lh5- 5c7b Feb 14  1999 AMarquee.info
[generic]                59632  207085  28.8% -lh5- 98de May  4  2002 AMarquee/AMarquee.guide
[generic]                 1096    1542  71.1% -lh5- 24e4 Apr 10  1998 AMarquee/AMarquee.guide.info
[generic]                  152     152 100.0% -lh0- e0e0 May  4  2002 AMarquee/AMarquee.guide.sig
[generic]                14665   26840  54.6% -lh5- eb8b May  4  2002 AMarquee/amarquee.library
[generic]                  152     152 100.0% -lh0- 948d May  4  2002 AMarquee/AMarquee.library.sig
[generic]                 3289    7785  42.2% -lh5- ec5c May  4  2002 AMarquee/AMarquee.readme
[generic]                  268     835  32.1% -lh5- 2b11 Apr 10  1998 AMarquee/AMarquee.readme.info
[generic]                  152     152 100.0% -lh0- 2cda May  4  2002 AMarquee/AMarquee.readme.sig
[generic]                23955   46528  51.5% -lh5- e433 Aug  6  2000 AMarquee/AMarqueed
[generic]                  152     152 100.0% -lh0- 216d Aug  6  2000 AMarquee/amarqueed.sig
[generic]                32813  135666  24.2% -lh5- 5b20 Mar 24  2002 AMarquee/autodoc/amarquee.doc
[generic]                 1604    4123  38.9% -lh5- d420 Apr 10  1998 AMarquee/EditTextFile.rexx
[generic]                 6410   11260  56.9% -lh5- 07b8 Aug  6  2000 AMarquee/examples/AmarqueeDebug
[generic]                 2513    7426  33.8% -lh5- 5e18 Aug  6  2000 AMarquee/examples/amarqueedebug.c
[generic]                 2323    6753  34.4% -lh5- db7d Apr 10  1998 AMarquee/examples/amarqueedebug.cpp
[generic]                 2305    7058  32.7% -lh5- 0965 Aug  6  2000 AMarquee/examples/amarqueedebug.rexx
[generic]                 7303   13084  55.8% -lh5- 4d14 Aug  6  2000 AMarquee/examples/AMarqueeDebugMultiThread
[generic]                 3285    9720  33.8% -lh5- a3ff Aug  6  2000 AMarquee/examples/AMarqueeDebugMultiThread.c
[generic]                 5541    9264  59.8% -lh5- f146 Aug  6  2000 AMarquee/examples/amarqueehost
[generic]                 1564    4180  37.4% -lh5- 21a9 Aug  6  2000 AMarquee/examples/amarqueehost.c
[generic]                 2116    6383  33.2% -lh5- 313a Aug  6  2000 AMarquee/examples/amarqueehost.rexx
[generic]                 6971   11936  58.4% -lh5- 9868 Aug  6  2000 AMarquee/examples/amarqueeserver
[generic]                 1922    5312  36.2% -lh5- fd0d Aug  6  2000 AMarquee/examples/AMarqueeServer.c
[generic]                 4997    8168  61.2% -lh5- c294 Aug  6  2000 AMarquee/examples/amarqueesharedmp
[generic]                 1632    5296  30.8% -lh5- bf7b Aug  6  2000 AMarquee/examples/amarqueesharedmp.c
[generic]                 5601    9340  60.0% -lh5- a827 Aug  6  2000 AMarquee/examples/amarqueesocketdebug
[generic]                 1751    4245  41.2% -lh5- 9b81 Aug  6  2000 AMarquee/examples/amarqueesocketdebug.c
[generic]                 5414    9024  60.0% -lh5- 8cfe Aug  6  2000 AMarquee/examples/amarqueesockethost
[generic]                 1417    3379  41.9% -lh5- fd52 Aug  6  2000 AMarquee/examples/amarqueesockethost.c
[generic]                  319     656  48.6% -lh5- 0179 Aug  6  2000 AMarquee/examples/amarqueetags.o
[generic]                 4788    7468  64.1% -lh5- b73e Aug  6  2000 AMarquee/examples/BounceCount
[generic]                 1169    2915  40.1% -lh5- 7a53 Aug  6  2000 AMarquee/examples/BounceCount.c
[generic]                  275     522  52.7% -lh5- 53fc Aug  6  2000 AMarquee/examples/dmakefile
[generic]                  262     494  53.0% -lh5- 224c Apr 10  1998 AMarquee/examples/dmakefile.bak
[generic]                 4812    7600  63.3% -lh5- 563c Aug  6  2000 AMarquee/examples/geturl
[generic]                 1351    3240  41.7% -lh5- 6eaa Aug  6  2000 AMarquee/examples/GetURL.c
[generic]                 1247    2788  44.7% -lh5- 5704 Aug  6  2000 AMarquee/examples/geturl.rexx
[generic]                 5021    7972  63.0% -lh5- 8cbd Mar 24  2002 AMarquee/examples/GetURL_Hook1
[generic]                 2607    7527  34.6% -lh5- f513 Mar 24  2002 AMarquee/examples/GetURL_Hook1.c
[generic]                 4924    7792  63.2% -lh5- 0be4 Aug  6  2000 AMarquee/examples/geturl_Hook2
[generic]                 1855    4588  40.4% -lh5- 463a Aug  6  2000 AMarquee/examples/GetURL_Hook2.c
[generic]                 1104    2431  45.4% -lh5- db2e Aug  6  2000 AMarquee/examples/killclients.rexx
[generic]                 6495   10552  61.6% -lh5- 56fb Aug  6  2000 AMarquee/examples/MiniIRC
[generic]                 2271    6544  34.7% -lh5- 2c99 Aug  6  2000 AMarquee/examples/MiniIRC.c
[generic]                 1984    3336  59.5% -lh5- ab97 Aug  6  2000 AMarquee/examples/PascalTest
[generic]                  506    1147  44.1% -lh5- e58b Aug  6  2000 AMarquee/examples/PascalTest.p
[generic]                 4500    7052  63.8% -lh5- 2149 Aug  6  2000 AMarquee/examples/RemoveTest
[generic]                 1039    2551  40.7% -lh5- 28b9 Aug  6  2000 AMarquee/examples/RemoveTest.c
[generic]                 5793    9400  61.6% -lh5- cc9a Aug  6  2000 AMarquee/examples/SillyGame
[generic]                 2592    8219  31.5% -lh5- 8c0b Aug  6  2000 AMarquee/examples/SillyGame.c
[generic]                 4774    7472  63.9% -lh5- 3cc0 Aug  6  2000 AMarquee/examples/StreamCheck
[generic]                 1245    3137  39.7% -lh5- f6c5 Aug  6  2000 AMarquee/examples/StreamCheck.c
[generic]                 4699    7336  64.1% -lh5- 6195 Aug  6  2000 AMarquee/examples/Streamgen
[generic]                 1093    2617  41.8% -lh5- baaf Aug  6  2000 AMarquee/examples/streamgen.c
[generic]                 4788    7528  63.6% -lh5- 2ab9 Aug  6  2000 AMarquee/examples/Synctest
[generic]                 1305    3255  40.1% -lh5- 68d7 Aug  6  2000 AMarquee/examples/SyncTest.c
[generic]                 1169    2649  44.1% -lh5- e56f Aug  6  2000 AMarquee/examples/sysmessage.rexx
[generic]                 1521    4974  30.6% -lh5- c548 Mar 24  2002 AMarquee/include/amiga/clib/AMarquee49_protos.h
[generic]                 1567    5622  27.9% -lh5- ca6a Mar 24  2002 AMarquee/include/amiga/clib/AMarquee_protos.h
[generic]                  364    1458  25.0% -lh5- 2fda Mar 24  2002 AMarquee/include/amiga/dice/amarqueetags.c
[generic]                  319     656  48.6% -lh5- 0179 Mar 24  2002 AMarquee/include/amiga/dice/amarqueetags.o
[generic]                  509    1584  32.1% -lh5- 1732 Mar 24  2002 AMarquee/include/amiga/fd/AMarquee49_lib.fd
[generic]                  583    1820  32.0% -lh5- 231a Mar 24  2002 AMarquee/include/amiga/fd/AMarquee_lib.fd
[generic]                 1567   13946  11.2% -lh5- 4f58 Mar 24  2002 AMarquee/include/amiga/FPC/amarquee.pas
[generic]                 1313   11097  11.8% -lh5- a968 Mar 24  2002 AMarquee/include/amiga/inline/AMarquee.h
[generic]                 1265    7072  17.9% -lh5- 714c Mar 24  2002 AMarquee/include/amiga/inline/AMarquee49.h
[generic]                 1610    8708  18.5% -lh5- a7d2 Apr  8  2000 AMarquee/include/amiga/lib/amarquee.lib
[generic]                 2523    6377  39.6% -lh5- 3154 Mar 24  2002 AMarquee/include/amiga/libraries/AMarquee.h
[generic]                 1720    4214  40.8% -lh5- a142 Mar 24  2002 AMarquee/include/amiga/libraries/AMarquee49.h
[generic]                 3190   12059  26.5% -lh5- 92f6 Mar 24  2002 AMarquee/include/amiga/PCQ/AMarquee.i
[generic]                 1223    8004  15.3% -lh5- 5f7f Mar 24  2002 AMarquee/include/amiga/PCQ/AMarquee.lib
[generic]                 1050    5521  19.0% -lh5- ef8d Mar 24  2002 AMarquee/include/amiga/pragmas/AMarquee49_pragmas.h
[generic]                 1255    6960  18.0% -lh5- 4c25 Mar 24  2002 AMarquee/include/amiga/pragmas/AMarquee_pragmas.h
[generic]                  259     505  51.3% -lh5- c49f Mar 24  2002 AMarquee/include/amiga/proto/AMarquee.h
[generic]                  261     511  51.1% -lh5- 9768 Mar 24  2002 AMarquee/include/amiga/proto/AMarquee49.h
[generic]                  217     409  53.1% -lh5- 25f5 Mar 19  2000 AMarquee/include/amiga/proto/gnu/AMarquee.h
[generic]                  221     413  53.5% -lh5- fb88 Mar 19  2000 AMarquee/include/amiga/proto/gnu/AMarquee49.h
[generic]                 1542   14712  10.5% -lh5- 8096 Mar 24  2002 AMarquee/include/amiga/vbcclib/amarquee.lib
[generic]                 2957   13408  22.1% -lh5- 6603 Mar 24  2002 AMarquee/include/Session.h
[generic]                 2870   12182  23.6% -lh5- 17fb Mar 19  2000 AMarquee/include/Session49.h
[generic]                 5420   21545  25.2% -lh5- c294 Mar 24  2002 AMarquee/Install_AMarquee
[generic]                  329     612  53.8% -lh5- c73e Apr 10  1998 AMarquee/Install_AMarquee.info
[generic]                  910    1318  69.0% -lh5- 2b96 Aug  6  2000 AMarquee/public-pgp-key.asc
[generic]                 6865   13364  51.4% -lh5- 0b64 May  4  2002 AMarquee/rexxamarquee.library
[generic]                  152     152 100.0% -lh0- 149e May  4  2002 AMarquee/RexxAMarquee.library.sig
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        86 files  319921  884839  36.2%            May  5  2002

Aminet © 1992-2024 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>