secret-tool - Store and retrieve passwords
secret-tool store --label='Label' {attribute} {value} ...
secret-tool lookup {attribute} {value} ...
secret-tool clear {attribute} {value} ...
secret-tool search [--all]{attribute} {value} ...
SECRET-TOOL(1) User Commands SECRET-TOOL(1)
NAME
secret-tool - Store and retrieve passwords
SYNOPSIS
secret-tool store --label='Label' {attribute} {value} ...
secret-tool lookup {attribute} {value} ...
secret-tool clear {attribute} {value} ...
secret-tool search [--all]{attribute} {value} ...
DESCRIPTION
secret-tool is a command line tool that can be used to store and
retrieve passwords.
Each password is stored in an item. Items are uniquely identified by a
set of attribute keys and values. When storing a password you must
specify unique pairs of attributes names and values, and when looking
up a password you provide the same attribute name and value pairs.
STORE
To store a password run secret-tool with the store argument. You must
also specify a label for the password with the --label argument. This
label will be displayed in the password manager.
Make sure to pass a unique set of attributes names and values when
storing a password. If the attributes match an already existing item,
it will be updated instead of creating a new item.
If invoked from a terminal or tty, then the password to store will be
prompted for and only one line will be accepted.
A password to store can also be piped in via stdin. The password will
be the contents of stdin until EOF. If you provide a newline via stdin
it will be stored as part of the password.
LOOKUP
To lookup a password run secret-tool with the lookup argument. Specify
the same same attribute names and value pairs that you passed when
storing the password.
If multiple items match the attribute provided, then the first password
that is already unlocked will be returned. If necessary an item will be
unlocked.
When printing the password to a terminal or tty, an extra newline will
be added after the password.
CLEAR
To remove a password run secret-tool with the clear argument. Specify
the same attribute name and value pairs that you passed when storing
the password.
All unlocked items that match the attributes will be removed.
SEARCH
This command searches for and prints details on matching items in
secret service. Specify the same attribute and value pairs that you
passed in when storing the password. You can use the following options:
--all
Return all matching results, rather than just the one of the
matches. Without this option, the first unlocked match returned
from the service will be printed.
--unlock
Unlock items that are locked and then print out their details.
Without this option, locked items are skipped.
EXIT STATUS
On success 0 is returned, a non-zero failure code otherwise.
EXAMPLES
Example 1. Storing, retrieving, and clearing a password
$ secret-tool store --label='My password' key1 value1 key2 value2
Password: My password
$ secret-tool lookup key1 value1 key2 value2
My password
$ secret-tool clear key1 value1 key2 value2
BUGS
The bug tracker can be reached by visiting the website
https://gitlab.gnome.org/GNOME/libsecret/issues. Before sending a bug
report, please verify that you have the latest version of secret-tool.
Many bugs (major and minor) are fixed at each release, and if yours is
out of date, the problem may already have been solved.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------------+
|Availability | library/gnome/libsecret |
+---------------+-------------------------+
|Stability | Pass-through volatile |
+---------------+-------------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
https://download.gnome.org/sources/libsecret/0.20/libsecret-0.20.4.tar.xz.
Further information about this software can be found on the open source
community website at https://wiki.gnome.org/Projects/Libsecret.
XDG SECRET-TOOL(1)