RELEVATION

Section: User Commands (1)
Index Return to Main Contents
 

NAME

relevation --- command-line searcher for Revelation files  

SYNOPSIS

relevation [options] [search string [...] ]  

DESCRIPTION

Access and print or search passwords in a Revelation password file.

Only read access is provided, to edit the files Revelation must be used.

With a search string, only entries that match the search string in any of its fields will be printed.

When no search string is provided the whole list of entries will be printed.  

OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-f file.revelation, --file=file.revelation
File name of the revelation file (the file containing the list of stored credentials).
-p password, --password=password
Decryption password.
-a, --ask, -0, --stdin
Ask interactively for password.
When -a or --ask is used a prompt will be printed.
Use either one of this variants or --password.
-t type, --type=type
Print only entries of a certain type.
Known types: creditcard, cryptokey, database, door, email, folder, ftp, generic, phone, shell, website.
If preceded by a slash it will be negated, i.e. `-website' will select entries that are not of type website.
When searching for a string, folders are skipped (equivalent to `--type=-folder').
-i, --case-insensitive
When searching for text, disregard case.
This is the default behaviour.
If the search string contains special/non-English characters this is likely to fail.
-c, --case-sensitive
When searching for text, obey case.
-A, --and
When multiple search terms are used, use an AND operator to combine them. All search terms will be combined in a single search, only entries that match every search term will be selected.
-O, --or
When multiple search terms are used, use an OR operator to combine them. A different search will be issued for each search term. This is the default and the original mode of operation.
-s search string, --search=search string, search string
Search the file for a pice of text. All fields will be searched. There's no need to use the -s or --search option names, any unnamed argument will be considered a search term.
-h, --help
Show summary of options.
--version
Show version information for relevation.
 

CONFIGURATION FILE

A configuration file `.relevation.conf' located at the user's home directory can be used to avoid having to provide the filename and/or password on each run.

Example `~/.relevation.conf':

 [relevation] 
 file=~/passwords.revelation 
 password=my secret password 
 mode=and 

Both file and password are optional, so you can store the filename without storing the password.

Please understand your password is stored in this file in clear text, modify the file permissions appropriately so that only your user can read it, otherwise your master password might be compromised and hence all your stored password will be too.

mode is optional ("or" by default), only the values and and or are recognized, corresponding to the matching --and and --or options (any other value will be ignored).  

SEE ALSO

revelation (1)  

AUTHOR

This manual page was written by Toni Corvera <outlyer@gmail.com>. Permission is granted to copy, distribute and/or modify this document under the terms of a BSD 2-clause license.
 


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
CONFIGURATION FILE
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:52:13 GMT, May 23, 2014