kwalletcli(1)
NAME
kwalletcli --- command line interface to the KDE Wallet
SYNOPSIS
kwalletcli [-q] -hV
kwalletcli [-q] -f folder -e entry [-P | -p password]
DESCRIPTION
The kwalletcli utility is a command line interface to KWallet. It will
only work if KDE is running (DCOP) and reachable (via X11). kwalletcli
can be used to get password entries from the Wallet, or to write them
there.
The options are as follows:
-e entry Define the key (entry) to use when accessing the Wallet.
Mandatory.
-f folder Set the folder to use when accessing the Wallet. Mandatory.
-h Display the usage.
-P Read the password to write from standard input. Currently
limited to 65535 octets.
-p password Write password into the designated location in the Wallet.
-q Be more quiet. In combination with -V, do not display
anything.
-V Display the kwalletcli version information.
Default mode of operation, that is, unless -P or -p are used, is to read
the password from the Wallet and print it to standard output as-is,
without any trailing newline.
All input and output is assumed to be in UTF-8. The password string
(whether read from standard input or command line) is now converted from
"possibly UTF-8 but binary transparent" to standards-conformant UTF-8 for
the Qt side, and back upon reading out.
RETURN VALUES
The kwalletcli utility exits 0 on success or >0 if an error occurred:
1 The entry specified cannot be found (read access).
2 The usage was shown.
3 The Wallet could not be opened. May be a missing DCOP connection.
Perhaps DISPLAY is not set.
4 The folder specified cannot be found (read access).
5 The folder specified cannot be opened.
6 The value to the key specified could not be retrieved.
8 An error occurred trying to write the value.
The exit codes 1 and 4, on reading, are not fatal; they merely indicate
that the folder or entry specified does not exist. The other errors are
fatal and may be used to indicate the user that the KWallet should not be
used any more during the current session.
ENVIRONMENT
DISPLAY The X11 display to use for communicating with the KDE Wallet.
SEE ALSO
kwalletcli_getpin(1)
AUTHORS
kwalletcli was written by mirabilos <m@mirbsd.org> mostly for tarent
solutions GmbH.
CAVEATS
Do not use -p password to store it, unless you absolutely must. It is a
security risk, because the command line invocation is public information
in a normal Unix environment. Use -P instead and provide the password on
standard input.
Beware of trailing newlines, especially outside of mksh(1) scripts!
BUGS
If DISPLAY is not set, not valid, or kdeinit or kdeinit4 cannot start for
other reasons, kwalletcli may not recover gracefully. In KDE 4 versions,
this may even result in a Segmentation fault. The author does not know
of a way to catch this early; patches are welcome.
There is no way (yet) to set a wallet other than the default wallet.
While this is a possible enhancement to the kwalletcli CLI, there is no
feasible way to expose this functionality to the various front-ends, such
as pinentry-kwallet(1), anyway, so the priority of fixing this is low.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
