1RELEVATION(1)               General Commands Manual              RELEVATION(1)
2
3
4

NAME

6       relevation — command-line searcher for Revelation files
7

SYNOPSIS

9       relevation [options]  [search string  [...] ]
10

DESCRIPTION

12       Access and print or search passwords in a Revelation password file.
13
14       Only  read  access  is  provided,  to edit the files Revelation must be
15       used.
16
17       With a search string, only entries that match the search string in  any
18       of its fields will be printed.
19
20       When  no  search  string  is provided the whole list of entries will be
21       printed.
22

OPTIONS

24       This program follows the usual  GNU  command  line  syntax,  with  long
25       options  starting  with  two  dashes  (`-').   A  summary of options is
26       included below.
27
28       -f file.revelation, --file=file.revelation
29                 File name of the revelation file  (the  file  containing  the
30                 list of stored credentials).
31
32       -p password, --password=password
33                 Decryption password.
34
35       -a, --ask, -0, --stdin
36                 Ask interactively for password.
37
38                 When -a or --ask is used a prompt will be printed.
39
40                 Use either one of this variants or --password.
41
42       -t type, --type=type
43                 Print only entries of a certain type.
44
45                 Known  types:  creditcard,  cryptokey, database, door, email,
46                 folder, ftp, generic, phone, shell, website.
47
48                 If preceded by a slash it will be  negated,  i.e.  `-website'
49                 will select entries that are not of type website.
50
51                 When  searching for a string, folders are skipped (equivalent
52                 to `--type=-folder').
53
54       -i, --case-insensitive
55                 When searching for text, disregard case.
56
57                 This is the default behaviour.
58
59                 If the search string contains special/non-English  characters
60                 this is likely to fail.
61
62       -c, --case-sensitive
63                 When searching for text, obey case.
64
65       -A, --and When  multiple  search terms are used, use an AND operator to
66                 combine them. All search terms will be combined in  a  single
67                 search,  only  entries  that  match every search term will be
68                 selected.
69
70       -O, --or  When multiple search terms are used, use an  OR  operator  to
71                 combine  them.  A  different  search  will be issued for each
72                 search term. This is the default and  the  original  mode  of
73                 operation.
74
75       -s search string, --search=search string, search string
76                 Search  the  file  for  a  pice  of  text. All fields will be
77                 searched. There's no need to use the -s  or  --search  option
78                 names, any unnamed argument will be considered a search term.
79
80       -h, --help
81                 Show summary of options.
82
83       --version Show version information for relevation.
84

CONFIGURATION FILE

86       A  configuration  file  `.relevation.conf'  located  at the user's home
87       directory can be used to avoid having to provide  the  filename  and/or
88       password on each run.
89
90       Example `~/.relevation.conf':
91
92        [relevation]
93        file=~/passwords.revelation
94        password=my secret password
95        mode=and
96
97       Both  file  and  password  are  optional, so you can store the filename
98       without storing the password.
99
100       Please understand your password is stored in this file in  clear  text,
101       modify  the  file  permissions appropriately so that only your user can
102       read it, otherwise your master password might be compromised and  hence
103       all your stored password will be too.
104
105       mode is optional ("or" by default), only the values and and or are rec‐
106       ognized, corresponding to the matching  --and  and  --or  options  (any
107       other value will be ignored).
108

SEE ALSO

110       revelation (1)
111

AUTHOR

113       This manual page was written by Toni Corvera <outlyer@gmail.com>.  Per‐
114       mission is granted to copy,  distribute  and/or  modify  this  document
115       under the terms of a BSD 2-clause license.
116
117
118
119
120                                                                 RELEVATION(1)