source: perl/modules/jabber.pl @ 6e9e50e

barnowl_perlaimdebianrelease-1.10release-1.4release-1.5release-1.6release-1.7release-1.8release-1.9
Last change on this file since 6e9e50e was 6e9e50e, checked in by Nelson Elhage <nelhage@mit.edu>, 17 years ago
Update to use new N::J MUC features
  • Property mode set to 100644
File size: 21.1 KB
Line 
1# -*- mode: cperl; cperl-indent-level: 4; indent-tabs-mode: nil -*-
2package owl_jabber;
3use warnings;
4use strict;
5
6use Authen::SASL qw(Perl);
7use Net::Jabber;
8use Net::DNS;
9use Getopt::Long;
10
11################################################################################
12# owl perl jabber support
13#
14# XXX Todo:
15# Rosters for MUCs
16# More user feedback
17#  * joining MUC
18#  * parting MUC
19#  * presence (Roster and MUC)
20# Implementing formatting and logging callbacks for C
21# Appropriate callbacks for presence subscription messages.
22#  * Current behavior => auto-accept (default for Net::Jabber)
23#
24################################################################################
25
26our $connections;
27our %vars;
28
29sub onStart {
30    if ( eval { \&owl::queue_message } ) {
31        register_owl_commands();
32        push @::onMainLoop,     sub { owl_jabber::onMainLoop(@_) };
33        push @::onGetBuddyList, sub { owl_jabber::onGetBuddyList(@_) };
34    }
35    else {
36
37        # Our owl doesn't support queue_message. Unfortunately, this
38        # means it probably *also* doesn't support owl::error. So just
39        # give up silently.
40    }
41}
42
43push @::onStartSubs, sub { owl_jabber::onStart(@_) };
44
45sub onMainLoop {
46    return if ( !connected() );
47
48    foreach my $jid ( keys %$connections ) {
49        my $client = \$connections->{$jid}->{client};
50
51        my $status = $$client->Process(0);
52        if ( !defined($status) ) {
53            owl::error("Jabber account $jid disconnected!");
54            do_logout($jid);
55        }
56        if ($::shutdown) {
57            do_logout($jid);
58            return;
59        }
60    }
61}
62
63sub blist_listBuddy {
64    my $roster = shift;
65    my $buddy  = shift;
66    my $blistStr .= "    ";
67    my %jq  = $$roster->query($buddy);
68    my $res = $$roster->resource($buddy);
69
70    $blistStr .= $jq{name} ? $jq{name} : $buddy->GetJID();
71
72    if ($res) {
73        my %rq = $$roster->resourceQuery( $buddy, $res );
74        $blistStr .= " [" . ( $rq{show} ? $rq{show} : 'online' ) . "]";
75        $blistStr .= " " . $rq{status} if $rq{status};
76        $blistStr = boldify($blistStr);
77    }
78    else {
79        $blistStr .= $jq{ask} ? " [pending]" : " [offline]";
80    }
81
82    return $blistStr . "\n";
83}
84
85sub onGetBuddyList {
86    my $blist = "";
87    foreach my $jid ( keys %{$connections} ) {
88        my $roster = \$connections->{$jid}->{roster};
89        if ($$roster) {
90            $blist .= "\n" . boldify("Jabber Roster for $jid\n");
91
92            foreach my $group ( $$roster->groups() ) {
93                $blist .= "  Group: $group\n";
94                foreach my $buddy ( $$roster->jids( 'group', $group ) ) {
95                    $blist .= blist_listBuddy( $roster, $buddy );
96                }
97            }
98
99            my @unsorted = $$roster->jids('nogroup');
100            if (@unsorted) {
101                $blist .= "  [unsorted]\n";
102                foreach my $buddy (@unsorted) {
103                    $blist .= blist_listBuddy( $roster, $buddy );
104                }
105            }
106        }
107    }
108    return $blist;
109}
110
111################################################################################
112### Owl Commands
113sub register_owl_commands() {
114    owl::new_command(
115        jabberlogin => \&cmd_login,
116        { summary => "Log into jabber", }
117    );
118    owl::new_command(
119        jabberlogout => \&cmd_logout,
120        { summary => "Log out of jabber" }
121    );
122    owl::new_command(
123        jwrite => \&cmd_jwrite,
124        {
125            summary => "Send a Jabber Message",
126            usage   => "jwrite JID [-g] [-t thread] [-s subject]"
127        }
128    );
129    owl::new_command(
130        jlist => \&cmd_jlist,
131        {
132            summary => "Show your Jabber roster.",
133            usage   => "jlist"
134        }
135    );
136    owl::new_command(
137        jmuc => \&cmd_jmuc,
138        {
139            summary     => "Jabber MUC related commands.",
140            description => "jmuc sends jabber commands related to muc.\n\n"
141              . "The following commands are available\n\n"
142              . "join {muc}  Join a muc.\n\n"
143              . "part [muc]  Part a muc.\n"
144              . "            The muc is taken from the current message if not supplied.\n\n"
145              . "invite {jid} [muc]\n"
146              . "            Invite {jid} to [muc].\n"
147              . "            The muc is taken from the current message if not supplied.\n\n"
148              . "configure [muc]\n"
149              . "            Configure [muc].\n"
150              . "            Necessary to initalize a new MUC",
151            usage => "jmuc {command} {args}"
152        }
153    );
154}
155
156sub cmd_login {
157    my $cmd = shift;
158    my $jid = new Net::XMPP::JID;
159    $jid->SetJID(shift);
160
161    my $uid           = $jid->GetUserID();
162    my $componentname = $jid->GetServer();
163    my $resource      = $jid->GetResource() || 'owl';
164    $jid->SetResource($resource);
165    my $jidStr = $jid->GetJID('full');
166
167    if ( !$uid || !$componentname ) {
168        owl::error("usage: $cmd {jid}");
169        return;
170    }
171
172    if ( $connections->{$jidStr} ) {
173        owl::error("Already logged in as $jidStr.");
174        return;
175    }
176
177    my ( $server, $port ) = getServerFromJID($jid);
178
179    $connections->{$jidStr}->{client} = Net::Jabber::Client->new(
180        debuglevel => owl::getvar('debug') eq 'on' ? 1 : 0,
181        debugfile => 'jabber.log'
182    );
183    my $client = \$connections->{$jidStr}->{client};
184    $connections->{$jidStr}->{roster} =
185      $connections->{$jidStr}->{client}->Roster();
186
187    #XXX Todo: Add more callbacks.
188    # MUC presence handlers
189    $$client->SetMessageCallBacks(
190        chat      => sub { owl_jabber::process_incoming_chat_message(@_) },
191        error     => sub { owl_jabber::process_incoming_error_message(@_) },
192        groupchat => sub { owl_jabber::process_incoming_groupchat_message(@_) },
193        headline  => sub { owl_jabber::process_incoming_headline_message(@_) },
194        normal    => sub { owl_jabber::process_incoming_normal_message(@_) }
195    );
196
197    $vars{jlogin_connhash} = {
198        hostname      => $server,
199        tls           => 1,
200        port          => $port,
201        componentname => $componentname
202    };
203
204    my $status = $$client->Connect( %{ $vars{jlogin_connhash} } );
205
206    if ( !$status ) {
207        delete $connections->{$jidStr};
208        delete $vars{jlogin_connhash};
209        owl::error("We failed to connect");
210        return "";
211    }
212
213    $vars{jlogin_authhash} =
214      { username => $uid, resource => $resource, password => '' };
215    my @result = $$client->AuthSend( %{ $vars{jlogin_authhash} } );
216    if ( $result[0] ne 'ok' ) {
217        if ( $result[1] == 401 ) {
218            $vars{jlogin_jid} = $jidStr;
219            delete $connections->{$jidStr};
220            owl::start_password( "Password for $jidStr: ", \&do_login_with_pw );
221            return "";
222        }
223        owl::error(
224            "Error in connect: " . join( " ", $result[ 1 .. $#result ] ) );
225        do_logout($jidStr);
226        delete $vars{jlogin_connhash};
227        delete $vars{jlogin_authhash};
228        return "";
229    }
230    $connections->{$jidStr}->{roster}->fetch();
231    $$client->PresenceSend( priority => 1 );
232    queue_admin_msg("Connected to jabber as $jidStr");
233    delete $vars{jlogin_connhash};
234    delete $vars{jlogin_authhash};
235    return "";
236}
237
238sub do_login_with_pw {
239    $vars{jlogin_authhash}->{password} = shift;
240    my $jidStr = delete $vars{jlogin_jid};
241    if ( !$jidStr ) {
242        owl::error("Got password but have no jid!");
243    }
244
245    $connections->{$jidStr}->{client} = Net::Jabber::Client->new();
246    my $client = \$connections->{$jidStr}->{client};
247    $connections->{$jidStr}->{roster} =
248      $connections->{$jidStr}->{client}->Roster();
249
250    $$client->SetMessageCallBacks(
251        chat      => sub { owl_jabber::process_incoming_chat_message(@_) },
252        error     => sub { owl_jabber::process_incoming_error_message(@_) },
253        groupchat => sub { owl_jabber::process_incoming_groupchat_message(@_) },
254        headline  => sub { owl_jabber::process_incoming_headline_message(@_) },
255        normal    => sub { owl_jabber::process_incoming_normal_message(@_) }
256    );
257
258    my $status = $$client->Connect( %{ $vars{jlogin_connhash} } );
259    if ( !$status ) {
260        delete $connections->{$jidStr};
261        delete $vars{jlogin_connhash};
262        delete $vars{jlogin_authhash};
263        owl::error("We failed to connect");
264        return "";
265    }
266
267    my @result = $$client->AuthSend( %{ $vars{jlogin_authhash} } );
268
269    if ( $result[0] ne 'ok' ) {
270        owl::error(
271            "Error in connect: " . join( " ", $result[ 1 .. $#result ] ) );
272        do_logout($jidStr);
273        delete $vars{jlogin_connhash};
274        delete $vars{jlogin_authhash};
275        return "";
276    }
277
278    $connections->{$jidStr}->{roster}->fetch();
279    $$client->PresenceSend( priority => 1 );
280    queue_admin_msg("Connected to jabber as $jidStr");
281    delete $vars{jlogin_connhash};
282    delete $vars{jlogin_authhash};
283    return "";
284}
285
286sub do_logout {
287    my $jid = shift;
288    $connections->{$jid}->{client}->Disconnect();
289    delete $connections->{$jid};
290    queue_admin_msg("Jabber disconnected ($jid).");
291}
292
293sub cmd_logout {
294
295    # Logged into multiple accounts
296    if ( connected() > 1 ) {
297
298        # Logged into multiple accounts, no accout specified.
299        if ( !$_[1] ) {
300            my $errStr =
301"You are logged into multiple accounts. Please specify an account to log out of.\n";
302            foreach my $jid ( keys %$connections ) {
303                $errStr .= "\t$jid\n";
304            }
305            queue_admin_msg($errStr);
306        }
307
308        # Logged into multiple accounts, account specified.
309        else {
310            if ( $_[1] eq '-a' )    #All accounts.
311            {
312                foreach my $jid ( keys %$connections ) {
313                    do_logout($jid);
314                }
315            }
316            else                    #One account.
317            {
318                my $jid = resolveJID( $_[1] );
319                do_logout($jid) if ( $jid ne '' );
320            }
321        }
322    }
323    else                            # Only one account logged in.
324    {
325
326        do_logout( ( keys %$connections )[0] );
327    }
328    return "";
329}
330
331sub cmd_jlist {
332    if ( !( scalar keys %$connections ) ) {
333        owl::error("You are not logged in to Jabber.");
334        return;
335    }
336    owl::popless_ztext( onGetBuddyList() );
337}
338
339sub cmd_jwrite {
340    if ( !connected() ) {
341        owl::error("You are not logged in to Jabber.");
342        return;
343    }
344
345    my $jwrite_to      = "";
346    my $jwrite_from    = "";
347    my $jwrite_thread  = "";
348    my $jwrite_subject = "";
349    my $jwrite_type    = "chat";
350
351    my @args = @_;
352    shift;
353    local @ARGV = @_;
354    my $gc;
355    GetOptions(
356        'thread=s'  => \$jwrite_thread,
357        'subject=s' => \$jwrite_subject,
358        'account=s' => \$jwrite_from,
359        'groupchat' => \$gc
360    );
361    $jwrite_type = 'groupchat' if $gc;
362
363    if ( scalar @ARGV != 1 ) {
364        owl::error(
365            "Usage: jwrite JID [-g] [-t thread] [-s 'subject'] [-a account]");
366        return;
367    }
368    else {
369        $jwrite_to = shift @ARGV;
370    }
371
372    if ( !$jwrite_from ) {
373        if ( connected() == 1 ) {
374            $jwrite_from = ( keys %$connections )[0];
375        }
376        else {
377            owl::error("Please specify an account with -a {jid}");
378            return;
379        }
380    }
381    else {
382        $jwrite_from = resolveJID($jwrite_from);
383        return unless $jwrite_from;
384    }
385
386    $vars{jwrite} = {
387        to      => $jwrite_to,
388        from    => $jwrite_from,
389        subject => $jwrite_subject,
390        thread  => $jwrite_thread,
391        type    => $jwrite_type
392    };
393
394    owl::message(
395        "Type your message below.  End with a dot on a line by itself.  ^C will quit."
396       );
397    owl::start_edit_win( join( ' ', @args ), \&process_owl_jwrite );
398}
399
400sub cmd_jmuc {
401    die "You are not logged in to Jabber" unless connected();
402    my $ocmd = shift;
403    my $cmd  = shift;
404    if ( !$cmd ) {
405
406        #XXX TODO: Write general usage for jmuc command.
407        return;
408    }
409
410    my %jmuc_commands = (
411        join      => \&jmuc_join,
412        part      => \&jmuc_part,
413        invite    => \&jmuc_invite,
414        configure => \&jmuc_configure
415    );
416    my $func = $jmuc_commands{$cmd};
417    if ( !$func ) {
418        owl::error("jmuc: Unknown command: $cmd");
419        return;
420    }
421
422    {
423        local @ARGV = @_;
424        my $jid;
425        my $muc;
426        my $m = owl::getcurmsg();
427        if ( $m->is_jabber && $m->{jtype} eq 'groupchat' ) {
428            $muc = $m->{room};
429            $jid = $m->{to};
430        }
431
432        my $getopt = Getopt::Long::Parser->new;
433        $getopt->configure('pass_through');
434        $getopt->getoptions( 'account=s' => \$jid );
435        $jid ||= defaultJID();
436        if ($jid) {
437            $jid = resolveJID($jid);
438            return unless $jid;
439        }
440        else {
441            owl::error('You must specify an account with -a {jid}');
442        }
443        return $func->( $jid, $muc, @ARGV );
444    }
445}
446
447sub jmuc_join {
448    my ( $jid, $muc, @args ) = @_;
449    local @ARGV = @args;
450    my $password;
451    GetOptions( 'password=s' => \$password );
452
453    $muc = shift @ARGV
454      or die("Usage: jmuc join {muc} [-p password] [-a account]");
455
456    my $presence = new Net::Jabber::Presence;
457    $presence->SetPresence( to => $muc );
458    my $x = $presence->NewChild('http://jabber.org/protocol/muc');
459    $x->AddHistory()->SetMaxChars(0);
460    if ($password) {
461        $x->SetPassword($password);
462    }
463
464    $connections->{$jid}->{client}->Send($presence);
465}
466
467sub jmuc_part {
468    my ( $jid, $muc, @args ) = @_;
469
470    $muc = shift @args if scalar @args;
471    die("Usage: jmuc part {muc} [-a account]") unless $muc;
472
473    $connections->{$jid}->{client}
474      ->PresenceSend( to => $muc, type => 'unavailable' );
475    queue_admin_msg("$jid has left $muc.");
476}
477
478sub jmuc_invite {
479    my ( $jid, $muc, @args ) = @_;
480
481    my $invite_jid = shift @args;
482    $muc = shift @args if scalar @args;
483
484    die('Usage: jmuc invite {jid} [muc] [-a account]')
485      unless $muc && $invite_jid;
486
487    my $message = Net::Jabber::Message->new();
488    $message->SetTo($muc);
489    my $x = $message->NewChild('http://jabber.org/protocol/muc#user');
490    $x->AddInvite();
491    $x->GetInvite()->SetTo($invite_jid);
492    $connections->{$jid}->{client}->Send($message);
493    queue_admin_msg("$jid has invited $invite_jid to $muc.");
494}
495
496sub jmuc_configure {
497    my ( $jid, $muc, @args ) = @_;
498    $muc = shift @args if scalar @args;
499    die("Usage: jmuc configure [muc]") unless $muc;
500    my $iq = Net::Jabber::IQ->new();
501    $iq->SetTo($muc);
502    $iq->SetType('set');
503    my $query = $iq->NewQuery("http://jabber.org/protocol/muc#owner");
504    my $x     = $query->NewChild("jabber:x:data");
505    $x->SetType('submit');
506
507    $connections->{$jid}->{client}->Send($iq);
508    queue_admin_msg("Accepted default instant configuration for $muc");
509}
510
511################################################################################
512### Owl Callbacks
513sub process_owl_jwrite {
514    my $body = shift;
515
516    my $j = new Net::XMPP::Message;
517    $body =~ s/\n\z//;
518    $j->SetMessage(
519        to   => $vars{jwrite}{to},
520        from => $vars{jwrite}{from},
521        type => $vars{jwrite}{type},
522        body => $body
523    );
524    $j->SetThread( $vars{jwrite}{thread} )   if ( $vars{jwrite}{thread} );
525    $j->SetSubject( $vars{jwrite}{subject} ) if ( $vars{jwrite}{subject} );
526
527    my $m = j2o( $j, 'out' );
528    if ( $vars{jwrite}{type} ne 'groupchat' ) {
529
530        #XXX TODO: Check for displayoutgoing.
531        owl::queue_message($m);
532    }
533    $connections->{ $vars{jwrite}{from} }->{client}->Send($j);
534    delete $vars{jwrite};
535    owl::message("");   # Kludge to make the ``type your message...'' message go away
536}
537
538### XMPP Callbacks
539
540sub process_incoming_chat_message {
541    my ( $session, $j ) = @_;
542    owl::queue_message( j2o( $j, 'in' ) );
543}
544
545sub process_incoming_error_message {
546    my ( $session, $j ) = @_;
547    my %jhash = j2hash( $j, 'in' );
548    $jhash{type} = 'admin';
549    owl::queue_message( owl::Message->new(%jhash) );
550}
551
552sub process_incoming_groupchat_message {
553    my ( $session, $j ) = @_;
554
555    # HACK IN PROGRESS (ignoring delayed messages)
556    return if ( $j->DefinedX('jabber:x:delay') && $j->GetX('jabber:x:delay') );
557    owl::queue_message( j2o( $j, 'in' ) );
558}
559
560sub process_incoming_headline_message {
561    my ( $session, $j ) = @_;
562    owl::queue_message( j2o( $j, 'in' ) );
563}
564
565sub process_incoming_normal_message {
566    my ( $session, $j ) = @_;
567    my %props = j2hash( $j, 'in' );
568
569    # XXX TODO: handle things such as MUC invites here.
570
571    #    if ($j->HasX('http://jabber.org/protocol/muc#user'))
572    #    {
573    #   my $x = $j->GetX('http://jabber.org/protocol/muc#user');
574    #   if ($x->HasChild('invite'))
575    #   {
576    #       $props
577    #   }
578    #    }
579    #
580    owl::queue_message( owl::Message->new(%props) );
581}
582
583sub process_muc_presence {
584    my ( $session, $p ) = @_;
585    return unless ( $p->HasX('http://jabber.org/protocol/muc#user') );
586
587}
588
589### Helper functions
590
591sub j2hash {
592    my $j   = shift;
593    my $dir = shift;
594
595    my %props = (
596        type      => 'jabber',
597        direction => $dir
598    );
599
600    my $jtype = $props{jtype} = $j->GetType();
601    my $from = $j->GetFrom('jid');
602    my $to   = $j->GetTo('jid');
603
604    $props{from} = $from->GetJID('full');
605    $props{to}   = $to->GetJID('full');
606
607    my $account = ( $dir eq 'out' ) ? $props{from} : $props{to};
608
609    $props{recipient}  = $to->GetJID('base');
610    $props{sender}     = $from->GetJID('base');
611    $props{subject}    = $j->GetSubject() if ( $j->DefinedSubject() );
612    $props{thread}     = $j->GetThread() if ( $j->DefinedThread() );
613    $props{body}       = $j->GetBody() if ( $j->DefinedBody() );
614    $props{error}      = $j->GetError() if ( $j->DefinedError() );
615    $props{error_code} = $j->GetErrorCode() if ( $j->DefinedErrorCode() );
616    $props{xml}        = $j->GetXML();
617
618    if ( $jtype eq 'chat' ) {
619        $props{replycmd} =
620          "jwrite " . ( ( $dir eq 'in' ) ? $props{from} : $props{to} ) . " -a $account";
621        $props{isprivate} = 1;
622        $props{replysendercmd} = $props{replycmd};
623    }
624    elsif ( $jtype eq 'groupchat' ) {
625        my $nick = $props{nick} = $from->GetResource();
626        my $room = $props{room} = $from->GetJID('base');
627        $props{replycmd} = "jwrite -g $room -a $account";
628
629        $props{replysendercmd} = "jwrite " . $from->GetJID('full') . " -a $account";
630
631        $props{sender} = $nick || $room;
632        $props{recipient} = $room;
633
634        if ( $props{subject} && !$props{body} ) {
635            $props{body} =
636              '[' . $nick . " has set the topic to: " . $props{subject} . "]";
637        }
638    }
639    elsif ( $jtype eq 'normal' ) {
640        $props{replycmd}  = undef;
641        $props{isprivate} = 1;
642    }
643    elsif ( $jtype eq 'headline' ) {
644        $props{replycmd} = undef;
645    }
646    elsif ( $jtype eq 'error' ) {
647        $props{replycmd} = undef;
648        $props{body}     = "Error "
649          . $props{error_code}
650          . " sending to "
651          . $props{from} . "\n"
652          . $props{error};
653    }
654
655    return %props;
656}
657
658sub j2o {
659    return owl::Message->new( j2hash(@_) );
660}
661
662sub queue_admin_msg {
663    my $err = shift;
664    my $m   = owl::Message->new(
665        type      => 'admin',
666        direction => 'none',
667        body      => $err
668    );
669    owl::queue_message($m);
670}
671
672sub boldify($) {
673    my $str = shift;
674
675    return '@b(' . $str . ')' if ( $str !~ /\)/ );
676    return '@b<' . $str . '>' if ( $str !~ /\>/ );
677    return '@b{' . $str . '}' if ( $str !~ /\}/ );
678    return '@b[' . $str . ']' if ( $str !~ /\]/ );
679
680    my $txt = "\@b($str";
681    $txt =~ s/\)/\)\@b\[\)\]\@b\(/g;
682    return $txt . ')';
683}
684
685sub getServerFromJID {
686    my $jid = shift;
687    my $res = new Net::DNS::Resolver;
688    my $packet =
689      $res->search( '_xmpp-client._tcp.' . $jid->GetServer(), 'srv' );
690
691    if ($packet)    # Got srv record.
692    {
693        my @answer = $packet->answer;
694        return $answer[0]{target}, $answer[0]{port};
695    }
696
697    return $jid->GetServer(), 5222;
698}
699
700sub connected {
701    return scalar keys %$connections;
702}
703
704sub defaultJID {
705    return ( keys %$connections )[0] if ( connected() == 1 );
706    return;
707}
708
709sub resolveJID {
710    my $givenJidStr = shift;
711    my $givenJid    = new Net::XMPP::JID;
712    $givenJid->SetJID($givenJidStr);
713
714    # Account fully specified.
715    if ( $givenJid->GetResource() ) {
716
717        # Specified account exists
718        if ( defined $connections->{$givenJidStr} ) {
719            return $givenJidStr;
720        }
721        else    #Specified account doesn't exist
722        {
723            owl::error("Invalid account: $givenJidStr");
724        }
725    }
726
727    # Disambiguate.
728    else {
729        my $matchingJid = "";
730        my $errStr =
731          "Ambiguous account reference. Please specify a resource.\n";
732        my $ambiguous = 0;
733
734        foreach my $jid ( keys %$connections ) {
735            my $cJid = new Net::XMPP::JID;
736            $cJid->SetJID($jid);
737            if ( $givenJidStr eq $cJid->GetJID('base') ) {
738                $ambiguous = 1 if ( $matchingJid ne "" );
739                $matchingJid = $jid;
740                $errStr .= "\t$jid\n";
741            }
742        }
743
744        # Need further disambiguation.
745        if ($ambiguous) {
746            queue_admin_msg($errStr);
747        }
748
749        # Not one of ours.
750        elsif ( $matchingJid eq "" ) {
751            owl::error("Invalid account: $givenJidStr");
752        }
753
754        # Log out this one.
755        else {
756            return $matchingJid;
757        }
758    }
759    return "";
760}
Note: See TracBrowser for help on using the repository browser.