Changeset 722

Timestamp:

10/01/06 21:28:07 (2 years ago)

Author:

bradfitz

Message:

add changes, fix manifest, check in POD i forgot to check in earlier

Files:

• trunk/DJabberd/CHANGES (added)
• trunk/DJabberd/MANIFEST (modified) (5 diffs)
• trunk/DJabberd/Makefile.PL (modified) (1 diff)
• trunk/DJabberd/lib/DJabberd.pm (modified) (2 diffs)
• trunk/DJabberd/t/lib/djabberd-test.pl (modified) (1 diff)

trunk/DJabberd/MANIFEST

@@ +1 @@
+djabberd
+CHANGES
+Makefile.PL
+MANIFEST                        This list of files
+META.yml
-lib/DJabberd.pm
+lib/DJabberd/Agent.pm
+lib/DJabberd/Agent/Node.pm
-lib/DJabberd/Authen.pm
-lib/DJabberd/Authen/AllowedUsers.pm
-lib/DJabberd/Authen/InMemoryOnly.pm
-lib/DJabberd/Authen/StaticPassword.pm
+lib/DJabberd/Bot.pm
+lib/DJabberd/Bot/Admin.pm
+lib/DJabberd/BotContext.pm
-lib/DJabberd/Callback.pm
+lib/DJabberd/Cluster.pm
+lib/DJabberd/ClusterMessage.pm
+lib/DJabberd/ClusterMessage/DeliverStanza.pm
+lib/DJabberd/Component.pm
+lib/DJabberd/Component/Example.pm
+lib/DJabberd/Component/External.pm
+lib/DJabberd/Component/External/Connection.pm
+lib/DJabberd/Component/Node.pm
-lib/DJabberd/Connection.pm
+lib/DJabberd/Connection/Admin.pm
-lib/DJabberd/Connection/ClientIn.pm
+lib/DJabberd/Connection/ClusterIn.pm
+lib/DJabberd/Connection/ClusterOut.pm
-lib/DJabberd/Connection/DialbackVerify.pm
-lib/DJabberd/Connection/OldSSLClientIn.pm
@@ -12 +33 @@
-lib/DJabberd/Connection/ServerOut.pm
-lib/DJabberd/Connection/SimpleIn.pm
-Connection/ClusterIn
+DNS
-lib/DJabberd/Delivery.pm
-lib/DJabberd/Delivery/Local.pm
+lib/DJabberd/Delivery/LocalVHosts.pm
-lib/DJabberd/Delivery/S2S.pm
-lib/DJabberd/DialbackParams.pm
-lib/DJabberd/DNS.pm
-lib/DJabberd/HookDocs.pm
-lib/DJabberd/IQ.pm
@@ -26 +47 @@
-lib/DJabberd/Presence.pm
-lib/DJabberd/PresenceChecker.pm
+lib/DJabberd/PresenceChecker/Dummy.pm
-lib/DJabberd/PresenceChecker/Local.pm
+lib/DJabberd/Queue.pm
+lib/DJabberd/Queue/ClusterOut.pm
-lib/DJabberd/Queue/ServerOut.pm
-lib/DJabberd/Roster.pm
@@ -38 +62 @@
-lib/DJabberd/Stanza/StartTLS.pm
-lib/DJabberd/Stanza/StreamFeatures.pm
+lib/DJabberd/Stats.pm
-lib/DJabberd/StreamStart.pm
-lib/DJabberd/StreamVersion.pm
@@ -46 +71 @@
-lib/DJabberd/XMLElement.pm
-lib/DJabberd/XMLParser.pm
-Makefile.PL
-MANIFEST                        This list of files
-META.yml
-t/10-specimpl.t
-t/directed-presence.t

trunk/DJabberd/Makefile.PL

@@ -6 +6 @@
-              VERSION_FROM => 'lib/DJabberd.pm',
-              EXE_FILES    => ['djabberd'],
+              ABSTRACT_FROM => 'lib/DJabberd.pm',
-              PREREQ_PM    => {
-                  'Danga::Socket'                => 1.51,

trunk/DJabberd/lib/DJabberd.pm

@@ -42 +42 @@
-use DJabberd::Util qw(tsub as_bool as_num as_abs_path);
-
-0
+1
-
-our $logger = DJabberd::Log->get_logger();
@@ -547 +547 @@
-
-1;
+
+__END__
+
+=head1 NAME
+
+DJabberd - scalable, extensible Jabber/XMPP server.
+
+=head1 SYNOPSIS
+
+ $ djabberd --conf=config-file.conf --daemonize
+
+=head1 DESCRIPTION
+
+DJabberd was the answer to LiveJournal's Jabber (XMPP)
+server needs.  We needed:
+
+=over 4
+
+=item * good performance for tons of connected users
+
+=item * ability to scale to multiple nodes
+
+=item * ability to hook into LiveJournal at all places, not just auth
+
+=back
+
+Basically we wanted the swiss army knife of Jabber servers (think
+qpsmtpd or mod_perl), but none existed in any language.  While some
+popular Jabber servers let us do pluggable auth, none let us get our
+hands into roster storage, vcards, avatars, presence, etc.
+
+So we made DJabberd.  It's a Jabber server where almost everything
+defers to hooks to be implemented by plugins.  It does the core spec
+itself (including SSL, StartTLS, server-to-server, etc), but it
+doesn't come with any way to do authentication or storage or rosters,
+etc.  You'll need to go pick up a plugin to do those.
+
+You should be able to plop DJabberd into your existing systems /
+userbase with minimal pain.  Just find a plugin that's close (if a
+perfect match doesn't already exist!) and tweak.
+
+DJabberd is event-based so we can have really low per-connection
+memory requirements, smaller than is possible with a threaded jabber
+server.  Because of this, all plugins can operate asynchronously,
+taking as long as they want to finish their work, or to decline to the
+next handler.  (in the meantime, while plugins wait on a response from
+whatever they're talking to, the DJabberd event loop continues at full
+speed) However, that's more work, so some plugins may choose to
+operate synchronously, but they do so with the understanding that
+those plugins will cause the whole server to get bogged down.  If
+you're running a Jabber server for 5 users, you may not care that the
+SQLite authentication backend pauses your server for milliseconds at a
+time, but on a site with hundreds of thousands of connections, that
+wouldn't be acceptable.  Watch out for those plugins.
+
+=head1 HACKING
+
+Read HookDocs.pm, read the major base classes (Authen, RosterStorage,
+PresenceChecker), join the mailing list, ask questions ... we're here
+to help.  If you want more hooks, let us know!  If we forgot one, it
+doesn't hurt us to add more.
+
+=head1 COPYRIGHT
+
+This module is Copyright (c) 2006 Six Apart, Ltd.
+All rights reserved.
+
+You may distribute under the terms of either the GNU General Public
+License or the Artistic License, as specified in the Perl README file.
+
+=head1 WARRANTY
+
+This is free software. IT COMES WITHOUT WARRANTY OF ANY KIND.
+
+=head1 WEBSITE
+
+Visit:
+
+   http://danga.com/djabberd/
+
+=head1 AUTHORS
+
+Brad Fitzpatrick <brad@danga.com>
+
+Artur Bergman <sky@crucially.net>
+
+Jonathan Steinert <jsteinert@sixapart.com>
+

trunk/DJabberd/t/lib/djabberd-test.pl

@@ -8 +8 @@
-use DJabberd::TestSAXHandler;
-use DJabberd::RosterStorage::InMemoryOnly;
-use DJabberd::Plugin::MUC;
-use DJabberd::Util;
-use IO::Socket::UNIX;