+ Passwd::Keyring::KDEWallet - Password storage implementation based on
-Passwd::Keyring is about using secure storage for passwords
-and other credentials used in perl scripts and applications.
-Passwd::Keyring::KDEWallet uses KDE KWallet API to securely
-preserve passwords and is available to people using KDE
-desktop environment (or at least with installed kwallet).
+ KDE Wallet based implementation of Passwd::Keyring.
To install this module, run the following commands:
+ $keyring->set_password("John", "verysecret", "my-pseudodomain");
+ # And later, on next run maybe
+ my $password = $keyring->get_password("John", "my-pseudodomain");
+ $keyring->clear_password("John", "my-pseudodomain");
-SUPPORT AND DOCUMENTATION
+ Note: see Passwd::Keyring::Auto::KeyringAPI for detailed comments on
+ keyring method semantics (this document is installed with
+ Passwd::Keyring::Auto package).
-After installing, you can find documentation for this module with the
+ Initializes the processing. Croaks if kwallet does not seem to be
- perldoc Passwd::Keyring::KDEWallet
+ set_password(username, password, domain)
+ Sets (stores) password identified by given domain for given user
-You can also look for information at:
+ 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)
+ Returns info, whether this keyring actually saves passwords
+ Approach inspired by http://www.perlmonks.org/?node_id=869620.
+ Please report any bugs or feature requests to issue tracker at
+ You can find documentation for this module with the perldoc command.
+ perldoc Passwd::Keyring::KDEWallet
+ You can also look for information at:
+ Source code is tracked at:
+ Copyright 2010-2012 Marcin Kasperski.
-Copyright (C) 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.
-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.
-See http://dev.perl.org/licenses/ for more information.