DOKK / manpages / debian 11 / libpoe-component-irc-perl / POE::Component::IRC::Cookbook::Disconnecting.3pm.en
POE::Component::IRC::Cookbook::Disconnecting(3pm) User Contributed Perl Documentation POE::Component::IRC::Cookbook::Disconnecting(3pm)

POE::Component::IRC::Cookbook::Disconnecting - How to disconnect gracefully with PoCo-IRC

Shutting down an IRC bot can be quick and messy, or slow and graceful.

There are two ways you can shut down an IRC bot/client. The quick and dirty way is rather simple:

 exit;

It exits the program, shutting down the socket, and everybody online sees yet another "Connection reset by peer" or "Remote end closed the socket" or something.

As of version 6.50, all you need to do in order to shut down gracefully is to send a "shutdown" event to the IRC component. It will make sure your quit message (if any) gets delivered, and will forcibly disconnect if there are any problems (faulty server or network issues). After doing this, it will unregister all sessions and clean up after itself.

If you want to do something more elaborate on your own, take a look at the following documentation: logged in, "connected", "quit", "disconnect", and "unregister".

Rocco Caputo and Hinrik Örn Sigurðsson.

2018-01-01 perl v5.26.1