KWALLET-QUERY(1)   KWALLET-QUERY(1)


.SH "NAME" kwallet-query - KDE Wallet command-line manipulation tool


.SH "SYNOPSIS"


.sp kwallet-query OPTIONS wallet


.SH "DESCRIPTION"


.sp kwallet-query comes in handy when shell scripts need to read or update the KDE Wallet. It works by manipulating the entries displayed in the KDE Wallet Manager utility. It’s only parameter is the walletname the tool should read or update. The operation mode is specified by the options.


.SH "OPTIONS"


.PP -h,--help


Display a short help message.


.RE
.PP -l,--list-entries


List password entries. These are the folder names displayed in the KDE Wallet Manager utility. If the -f option is given, this will only display the subfolders of the specified folder.


.RE
.PP -r,--read-password Entry


Read the contents of the given Entry from the Foldersection of the wallet and output it on the standard output. Maps are exported as JSON object.


.RE
.PP -w,--write-password Entry


Write secrets to the given Entry under the Folder section of the given wallet. The secrets are read from the standard input. Maps take in input a well-formed JSON object. IMPORTANT previous wallet entry value will be overwritten by this option, so be careful when using it!


.RE
.PP -f,--folder Folder


Set the wallet folder to Folder value. By default Passwords is used.


.RE
.PP -v,--verbose


Output more information when performing the operation, to help debugging.


.RE


.SH "EXIT STATUS"


.PP 0


Success.


.RE
.PP 1


The wallet wallet was not found.


.RE
.PP 2


The wallet wallet could not be opened. For example, that would be an indication of a bad password entry or some other problem with the KDE Wallet system.


.RE
.PP 3


The Folder section was not found inside the wallet wallet. Perhaps the wallet file is corrupt?


.RE
.PP 4


The read or write operation has failed for some reason.


.RE


.SH "BUGS"


.sp Please report all bugs on the KDE bug reporting website: bugs.kde.org. Be sure to select “kwallet-query” when submitting your bug-report.


.SH "AUTHOR"


.sp kwallet-query was originally written by Valentin Rusu and is part of KDE.


.SH "COPYING"


.sp Copyright (C) 2015 Valentin Rusu. Free use of this software is granted under the terms of the GNU General Public License (GPL).

Valentin Rusu <kde@rusu.info>

Original author
2015-06-14   Frameworks 5.11