GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::AIM::CONNECTION (3)

.ds Aq ’

NAME

Net::AIM::Connection - Interface to an AIM connection

CONTENTS

SYNOPSIS

DESCRIPTION

This module handles the connection and communications between us and the server. It parses the incoming data and hands it off to handler methods if they are defined. It currently supports and follows the TOC protocol and contains methods to send out our information and messages.

METHODS

Net::AIM::Connection->new($hash_ref)



      Net::AIM::Connection-E<gt>new( {
         Screenname => perlaim,
         Password => yaddayadda,
         TocServer => toc.oscar.aol.com,
         TocPort => 80,
         AuthServer => login.oscar.aol.com,
         AuthPort => 5159
     }



Creates a new Connection object and tries to connect to the AIM TOC server. This method creates and objet and calls connect with all the arguments passed to it.

$aim_conn->new($hash_ref)



   $aim_conn-E<gt>new( {
         Screenname => perlaim,  #required
         Password => ilyegk,  #required
         TocServer => toc.oscar.aol.com,
         TocPort => 9898,
         AuthServer => login.oscar.aol.com,
         AutoReconnect => 1,
         Agent => Net::aim mychat, # DONT USE AIM!!!
         AuthPort => 5159
     } );



Sets up a connection to the AOL TOC server.

$aim->normalize($data)

This method normalizes $data by killing all but strict alphnumeric characters. Typically used for screen_names.

$aim_conn->send_im($screen_name, $message)

This method sends $message to $screen_name.

$aim_conn->set_idle($idle_time)

This method sets our idle time to $idle_time. If $idle_time is omitted it will be set to 0.

$aim_conn->add_buddy(@buddies)

This method adds @buddies to our buddy list that is set on the server.

$aim_conn->add_permit(@buddies)

This method adds @buddies to our permit list that is set on the server.

$aim_conn->add_deny(@buddies)

This method adds @buddies to our deny list that is set on the server.

$aim_conn->remove_buddy(@buddies)

This method removes @buddies from our buddy list that is set on the server.

$aim_conn->set_away($message)

This method sets our idle time to $idle_time. If $idle_time is omitted it will be set to 0.

$aim_conn->get_info($screen_name)

Sends an info request to the server for $screen_name. The server should reply with a URL which will contain the info requested about the user.

$aim_conn->set_info($info)

This method sets your info or profile information to $info on the server.

$aim_conn->evil($user, $anon)

Warn $screen_name. $anon: boolean value which will determine whether to warn the user anonymously or normally. Anonymous warnings are less severe.

$aim_conn->send_to_AOL($message)

Send $message to the server. This is used internally by other functions to send commands to the server.



   $aim_conn->send_to_AOL(toc_add_buddy perlaim)



$aim_conn->chat_invite($room, $msg, @buddies)

Invite @buddies to $room with the message $msg

$aim_conn->chat_accept($room_id)

This will accept an invitation that was sent to us for $room_id

$aim_conn->chat_leave($room_id)

This method instructs the server to take you out of the room $room_id

$aim_conn->chat_whisper($room_id,$user,$msg)

Whisper $msg to $user in the room $room_id

$aim_conn->chat_send_to_AOL($room_id, $message)

Send $message in chat room $room_id

$aim_conn->chat_join($roomname)

Send a request to enter the room $roomname

$aim_conn->connected()

Returns a boolean value based on the state of the object’s socket.

$aim->debug($debug)

Set whether to print DEBUGGING information to STDERRR. Accepts $debug which should be a boolean value.

$aim_conn->set_handler($evttype, \&coderef)

Set a sub routine to be called when $event is encountered:
$aim_conn->set_handler(’error’, \&on_errror);
$aim_conn->set_handler(’im_in’, \&on_im);

$aim_conn->encode($str)

This method returns $str encoded as per the TOC specs: escaped special chars ({}[]$) and enclosed in quotes (")

$aim_conn->encodePass($password)

This method roasts $password according to the TOC specs. The roasted password is returned.

$aim_conn->send_config($cfg_str)

Sends $cfg_str to the server to be used as configuration values for the account.

$aim_conn->read_and_parse()

Read a chunk of data off the connection to the server parse it and send it off to any defined handlers.

AUTHOR

Aryeh Goldsmith <perlaim@aryeh.net>.

URL

The Net::AIM project: http://www.aryeh.net/Net-AIM/

The Net::AIM bot list: http://www.nodoubtyo.com/aimbots/

SEE ALSO

perl(1)

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 21: You can’t have =items (as at line 107) unless the first thing after the =over is an =item
Around line 878: You forgot a ’=back’ before ’=head1’
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 AIM::CONNECTION (3) 2002-04-23

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.