NAME

Cocoa::NetworkChange - Checking network connection for OS X

SYNOPSIS

use Cocoa::EventLoop;
use Cocoa::NetworkChange;

on_network_change(sub {
    my $wlan = shift;
    # on connected
    if ($wlan->{ssid} && $wlan->{ssid} =~ /aterm/) {
        # ...
    }
}, sub {
    # on disconnected
});

Cocoa::EventLoop->run;

DESCRIPTION

Cocoa::NetworkChange checks network connection in real time. You can do something when you connected to a certain Wi-Fi network.

Note that if you disconnected with PPPoE authentication, Cocoa::NetworkChange guesses that it's connected to the network.

FUNCTIONS

on_network_change($connect_cb, [$disconnect_cb])

Call the callback on network connected or disconnected.

on_network_change(sub {
    my $wlan = shift;
    # on connected
}, sub {
    # on disconnected
});

$wlan->{ssid}

Service set identifier (SSID)

$wlan->{interface}

The BSD name of the interface (such as en0, en1)

$wlan->{mac_address}

The hardware media access control (MAC) address

$wlan->{bssid}

Basic service set identifier (BSSID)

is_network_connected()

(immediately) Return 1, when you are connected to the network and 0 otherwise.

current_interface()

See above.

LICENSE

Copyright (C) Takumi Akiyama.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Takumi Akiyama <t.akiym@gmail.com>