.\"
.\" Copyright (c) 2014 Martijn van Duren <martijn@van.duren.eu>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: August 18 2016 $
.Dt PWSTORE 1
.Os
.Sh NAME
.Nm pwstore 
.Nd Manipulate and retrieve information from a pwstore database.
.Sh SYNOPSIS
.Nm
.Op Fl s Ar file
.Op Fl c Ar chain
.Op CeEmPd
.Sh DESCRIPTION
The
.Nm
utility is the default commandline interface to the
.Xr pwstore_safe_open 3
family of functions.
.Pp
The
.Ar s
argument is used to determine the pwstore
.Ar file .
If it is not specified it falls back to
.Xr pwstore_safe_default 3 .
The
.Ar c
argument specifies
.Ar chain
to be used inside the
.Ar file.
If not specified it loops over all available chains.
In case the
.Ar file
or
.Ar chain
don't exist the application asks if it should be created and prompts for a
passphrase.
.Pp
The
.Ar C
arguments prompts for a new passphrase on -, and
.Ar d
removes the most accurate match
.Pq entry -> chain -> safe .
.Pp
.Ar e
is used to create a new entry in
.Ar chain ,
whereas
.Ar E
is used to search for an entry inside
.Ar chain
or loop over all available chains.
See
.Xr pwstore_search_chain 3
for available search options.
.Pp
Found entries can be removed with the
.Ar d
option, or modified with the
.Ar m
option. Multiple
.Ar m
options can be specified and takes form of <keyword>=<value>.
.Sh EXIT STATUS
.Ex -std pwstore
.Sh SEE ALSO
.Xr pwstore_safe_open 3 ,