The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Passwd::Keyring::Gnome - Password storage implementation based on GNOME Keyring.

VERSION

Version 0.23

SYNOPSIS

Gnome Keyring based implementation of Keyring.

    use Passwd::Keyring::Gnome;

    my $keyring = Passwd::Keyring::Gnome->new();

    $keyring->set_password("John", "verysecret", "my-pseudodomain");
    # And later, on next run maybe
    my $password = $keyring->get_password("John", "my-pseudodomain");
    # plus
    $keyring->clear_password("John", "my-pseudodomain");

SUBROUTINES/METHODS

new

Initializes the processing. Croaks if gnome keyring does not seem to be available.

set_password(username, password, domain)

Sets (stores) password identified by given domain for given user

get_password($user_name, $domain)

Reads previously stored password for given user in given app. If such password can not be found, returns undef.

clear_password($user_name, $domain)

Removes given password (if present)

is_persistent

Returns info, whether this keyring actually saves passwords persistently.

(true in this case)

AUTHOR

Marcin Kasperski, <Marcin.Kasperski at mekk.waw.pl>

BUGS

Please report any bugs or feature requests to issue tracker at https://bitbucket.org/Mekk/perl-keyring-gnome.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Passwd::Keyring::Gnome

You can also look for information at:

    L<https://bitbucket.org/Mekk/perl-keyring-gnome>

LICENSE AND COPYRIGHT

Copyright 2010-2012 Marcin Kasperski.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.