pwman

Hex Artifact Content
Login

Artifact d04d869119ce7ff259fdb699b6c0433af943d6421137a1bfc563303891914a46:


0000: 0a 09 50 57 4d 61 6e 20 50 61 73 73 77 6f 72 64  ..PWMan Password
0010: 20 4d 61 6e 61 67 65 72 0a 09 2d 2d 2d 2d 2d 2d   Manager..------
0020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0030: 0a 0a 50 57 4d 61 6e 20 69 73 20 61 20 70 61 73  ..PWMan is a pas
0040: 73 77 6f 72 64 20 6d 61 6e 61 67 65 72 20 77 68  sword manager wh
0050: 69 63 68 20 75 73 65 73 20 67 70 67 20 65 6e 63  ich uses gpg enc
0060: 72 79 70 74 69 6f 6e 20 74 6f 20 73 61 66 65 67  ryption to safeg
0070: 75 61 72 64 20 79 6f 75 72 20 64 61 74 61 2e 0a  uard your data..
0080: 49 74 20 70 72 6f 76 69 64 65 73 20 61 20 73 69  It provides a si
0090: 6d 70 6c 65 20 61 6e 64 20 65 61 73 79 20 74 6f  mple and easy to
00a0: 20 75 73 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e   use command lin
00b0: 65 20 28 4e 43 75 72 73 65 73 29 20 69 6e 74 65  e (NCurses) inte
00c0: 72 66 61 63 65 20 74 6f 20 0a 6d 61 6e 61 67 65  rface to .manage
00d0: 2c 20 73 74 6f 72 65 2c 20 73 65 61 72 63 68 20  , store, search 
00e0: 61 6e 64 20 72 65 74 72 69 65 76 65 20 79 6f 75  and retrieve you
00f0: 72 20 70 61 73 73 77 6f 72 64 73 2e 0a 0a 54 68  r passwords...Th
0100: 65 20 6c 6f 6f 6b 20 61 6e 64 20 66 65 65 6c 20  e look and feel 
0110: 69 73 20 62 61 73 65 64 20 6f 6e 20 4a 61 61 6b  is based on Jaak
0120: 6b 6f 20 48 65 69 6e 6f 6e 65 6e 27 73 20 61 62  ko Heinonen's ab
0130: 6f 6f 6b 2e 0a 0a 0a 49 4e 53 54 41 4c 4c 41 54  ook....INSTALLAT
0140: 49 4f 4e 20 52 45 51 55 49 52 45 4d 45 4e 54 53  ION REQUIREMENTS
0150: 0a 0a 20 50 57 4d 61 6e 20 69 73 20 64 69 73 74  .. PWMan is dist
0160: 72 69 62 75 74 65 64 20 61 73 20 73 6f 75 72 63  ributed as sourc
0170: 65 20 66 69 6c 65 73 2c 20 61 6e 64 20 68 65 6e  e files, and hen
0180: 63 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 63  ce needs to be c
0190: 6f 6d 70 69 6c 65 64 20 61 6e 64 20 0a 20 69 6e  ompiled and . in
01a0: 73 74 61 6c 6c 65 64 20 6d 61 6e 75 61 6c 6c 79  stalled manually
01b0: 2e 20 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 63  . Installation c
01c0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 68 6f  onfiguration sho
01d0: 75 6c 64 20 63 68 65 63 6b 20 61 6e 64 20 62 72  uld check and br
01e0: 69 6e 67 20 69 6e 0a 20 61 6c 6c 20 64 65 70 65  ing in. all depe
01f0: 6e 64 65 6e 63 69 65 73 20 66 6f 72 20 79 6f 75  ndencies for you
0200: 2c 20 62 75 74 20 65 6e 73 75 72 65 20 79 6f 75  , but ensure you
0210: 20 68 61 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77   have the follow
0220: 69 6e 67 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20  ing development 
0230: 0a 20 6c 69 62 72 61 72 69 65 73 20 6f 6e 20 79  . libraries on y
0240: 6f 75 72 20 6d 61 63 68 69 6e 65 20 62 65 66 6f  our machine befo
0250: 72 65 20 63 6f 6d 6d 65 6e 63 69 6e 67 20 28 61  re commencing (a
0260: 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20  s configuration 
0270: 77 69 6c 6c 20 6e 65 65 64 20 0a 20 74 6f 20 62  will need . to b
0280: 65 20 72 65 73 74 61 72 74 65 64 20 66 72 6f 6d  e restarted from
0290: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 65   the beginning e
02a0: 61 63 68 20 74 69 6d 65 20 61 20 64 65 70 65 6e  ach time a depen
02b0: 64 65 6e 63 79 20 66 61 69 6c 73 29 3a 0a 0a 20  dency fails):.. 
02c0: 20 2a 20 67 63 63 20 6f 72 20 73 6f 6d 65 20 6f   * gcc or some o
02d0: 74 68 65 72 20 43 20 63 6f 6d 70 69 6c 65 72 0a  ther C compiler.
02e0: 20 20 2a 20 6c 69 62 63 36 20 73 74 61 6e 64 61    * libc6 standa
02f0: 72 64 20 43 20 64 65 76 65 6c 6f 70 6d 65 6e 74  rd C development
0300: 20 6c 69 62 72 61 72 69 65 73 0a 20 20 2a 20 6e   libraries.  * n
0310: 63 75 72 73 65 73 20 64 65 76 65 6c 6f 70 6d 65  curses developme
0320: 6e 74 20 6c 69 62 72 61 72 69 65 73 0a 20 20 2a  nt libraries.  *
0330: 20 6c 69 62 78 6d 6c 32 20 47 4e 4f 4d 45 20 58   libxml2 GNOME X
0340: 4d 4c 20 6c 69 62 72 61 72 79 0a 0a 20 59 6f 75  ML library.. You
0350: 20 63 61 6e 20 69 6e 73 74 61 6c 6c 20 61 6c 6c   can install all
0360: 20 6f 66 20 74 68 65 73 65 20 6f 6e 20 65 2e 67   of these on e.g
0370: 2e 20 55 62 75 6e 74 75 20 77 69 74 68 20 74 68  . Ubuntu with th
0380: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d  e following comm
0390: 61 6e 64 3a 0a 0a 20 20 25 20 73 75 64 6f 20 61  and:..  % sudo a
03a0: 70 74 2d 67 65 74 20 69 6e 73 74 61 6c 6c 20 6c  pt-get install l
03b0: 69 62 63 36 2d 64 65 76 20 6c 69 62 6e 63 75 72  ibc6-dev libncur
03c0: 73 65 73 35 2d 64 65 76 20 6c 69 62 78 6d 6c 32  ses5-dev libxml2
03d0: 20 67 63 63 20 0a 0a 20 4f 72 20 6f 6e 20 46 65   gcc .. Or on Fe
03e0: 64 6f 72 61 20 77 69 74 68 3a 0a 0a 20 20 25 20  dora with:..  % 
03f0: 73 75 64 6f 20 79 75 6d 20 69 6e 73 74 61 6c 6c  sudo yum install
0400: 20 67 6c 69 62 63 2d 64 65 76 65 6c 20 6e 63 75   glibc-devel ncu
0410: 72 73 65 73 2d 64 65 76 65 6c 20 6c 69 62 78 6d  rses-devel libxm
0420: 6c 32 2d 64 65 76 65 6c 20 67 63 63 0a 0a 0a 50  l2-devel gcc...P
0430: 52 45 2d 43 4f 4d 50 49 4c 41 54 49 4f 4e 0a 0a  RE-COMPILATION..
0440: 20 49 66 20 62 75 69 6c 64 69 6e 67 20 66 72 6f   If building fro
0450: 6d 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79  m the repository
0460: 20 73 6f 75 72 63 65 2c 20 61 73 20 6f 70 70 6f   source, as oppo
0470: 73 65 64 20 74 6f 20 61 20 7a 69 70 70 65 64 20  sed to a zipped 
0480: 28 2a 2e 74 61 72 2e 67 7a 29 0a 20 72 65 6c 65  (*.tar.gz). rele
0490: 61 73 65 20 69 74 20 77 69 6c 6c 20 62 65 20 6e  ase it will be n
04a0: 65 63 65 73 73 61 72 79 20 74 6f 20 67 65 6e 65  ecessary to gene
04b0: 72 61 74 65 20 74 68 65 20 4d 61 6b 65 66 69 6c  rate the Makefil
04c0: 65 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 65 20  e and configure 
04d0: 66 69 6c 65 20 69 6e 0a 20 6f 72 64 65 72 20 74  file in. order t
04e0: 6f 20 70 72 6f 63 65 65 64 20 77 69 74 68 20 63  o proceed with c
04f0: 6f 6d 70 6c 69 74 69 6f 6e 20 61 6e 64 20 69 6e  omplition and in
0500: 73 74 61 6c 6c 61 74 69 6f 6e 2e 20 52 75 6e 3a  stallation. Run:
0510: 0a 0a 20 25 20 61 75 74 6f 6d 61 6b 65 20 2d 2d  .. % automake --
0520: 61 64 64 2d 6d 69 73 73 69 6e 67 0a 0a 20 44 65  add-missing.. De
0530: 70 65 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 20 76  pening on your v
0540: 65 72 73 69 6f 6e 20 6f 66 20 61 75 74 6f 6d 61  ersion of automa
0550: 6b 65 2c 20 79 6f 75 20 6d 61 79 20 72 65 63 65  ke, you may rece
0560: 69 76 65 20 61 20 77 61 72 6e 69 6e 67 20 73 75  ive a warning su
0570: 63 68 20 61 73 20 22 59 6f 75 0a 20 73 68 6f 75  ch as "You. shou
0580: 6c 64 20 72 65 63 72 65 61 74 65 20 61 63 6c 6f  ld recreate aclo
0590: 63 61 6c 2e 6d 34 20 77 69 74 68 20 61 63 6c 6f  cal.m4 with aclo
05a0: 63 61 6c 20 61 6e 64 20 72 75 6e 20 61 75 74 6f  cal and run auto
05b0: 6d 61 6b 65 20 61 67 61 69 6e 22 2c 20 69 6e 20  make again", in 
05c0: 77 68 69 63 68 20 63 61 73 65 0a 20 72 75 6e 3a  which case. run:
05d0: 0a 0a 20 25 20 61 63 6c 6f 63 61 6c 20 0a 20 25  .. % aclocal . %
05e0: 20 61 75 74 6f 6d 61 6b 65 20 2d 2d 61 64 64 2d   automake --add-
05f0: 6d 69 73 73 69 6e 67 0a 20 0a 20 46 69 6e 61 6c  missing. . Final
0600: 6c 79 20 72 75 6e 3a 20 0a 0a 20 25 20 61 75 74  ly run: .. % aut
0610: 6f 63 6f 6e 66 0a 0a 20 0a 43 4f 4d 50 49 4c 41  oconf.. .COMPILA
0620: 54 49 4f 4e 20 41 4e 44 20 49 4e 53 54 41 4c 4c  TION AND INSTALL
0630: 41 54 49 4f 4e 0a 0a 20 41 6c 6c 20 74 61 73 6b  ATION.. All task
0640: 73 20 72 65 6c 61 74 65 64 20 74 6f 20 63 6f 6d  s related to com
0650: 70 69 6c 61 74 69 6f 6e 2c 20 64 65 70 6c 6f 79  pilation, deploy
0660: 6d 65 6e 74 20 65 74 63 2e 20 61 72 65 20 6d 61  ment etc. are ma
0670: 6e 61 67 65 64 20 62 79 20 74 68 65 20 43 0a 20  naged by the C. 
0680: 75 74 69 6c 69 74 79 20 6d 61 6b 65 2e 20 46 69  utility make. Fi
0690: 72 73 74 2c 20 63 6f 6e 66 69 67 75 72 65 20 74  rst, configure t
06a0: 68 65 20 70 72 6f 63 65 73 73 3a 20 66 72 6f 6d  he process: from
06b0: 20 77 69 74 68 69 6e 20 74 68 65 20 74 6f 70 2d   within the top-
06c0: 6c 65 76 65 6c 0a 20 64 69 72 65 63 74 6f 72 79  level. directory
06d0: 20 6f 66 20 74 68 65 20 64 69 73 74 72 69 62 75   of the distribu
06e0: 74 69 6f 6e 20 72 75 6e 0a 0a 20 20 25 20 2e 2f  tion run..  % ./
06f0: 63 6f 6e 66 69 67 75 72 65 0a 0a 20 49 66 20 79  configure.. If y
0700: 6f 75 20 61 6c 72 65 61 64 79 20 68 61 76 65 20  ou already have 
0710: 61 6c 6c 20 74 68 65 20 6e 65 63 65 73 73 61 72  all the necessar
0720: 79 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 69  y dependencies i
0730: 6e 73 74 61 6c 6c 65 64 20 74 68 65 6e 20 74 68  nstalled then th
0740: 69 73 0a 20 77 69 6c 6c 20 72 75 6e 20 69 74 73  is. will run its
0750: 20 63 6f 75 72 73 65 20 77 69 74 68 20 6e 6f 20   course with no 
0760: 65 72 72 6f 72 73 3b 20 6f 74 68 65 72 77 69 73  errors; otherwis
0770: 65 20 74 72 79 20 74 6f 20 66 69 78 20 61 6e 79  e try to fix any
0780: 20 66 61 69 6c 65 64 0a 20 64 65 70 65 6e 64 65   failed. depende
0790: 6e 63 69 65 73 20 28 6f 6e 20 55 62 75 6e 74 75  ncies (on Ubuntu
07a0: 2c 20 74 68 69 73 20 77 69 6c 6c 20 61 6c 77 61  , this will alwa
07b0: 79 73 20 62 65 20 70 6f 73 73 69 62 6c 65 20 75  ys be possible u
07c0: 73 69 6e 67 20 73 74 61 6e 64 61 72 64 0a 20 70  sing standard. p
07d0: 61 63 6b 61 67 65 73 29 2e 0a 0a 20 54 68 65 6e  ackages)... Then
07e0: 20 72 75 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69   run the followi
07f0: 6e 67 20 73 65 71 75 65 6e 63 65 20 6f 66 20 63  ng sequence of c
0800: 6f 6d 6d 61 6e 64 73 20 74 6f 20 63 6f 6d 70 69  ommands to compi
0810: 6c 65 2c 20 63 68 65 63 6b 20 61 6e 64 20 74 68  le, check and th
0820: 65 6e 0a 20 69 6e 73 74 61 6c 6c 20 74 68 65 20  en. install the 
0830: 63 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 79 3a  compiled binary:
0840: 0a 0a 20 20 25 20 6d 61 6b 65 0a 20 20 25 20 6d  ..  % make.  % m
0850: 61 6b 65 20 63 68 65 63 6b 0a 20 20 25 20 73 75  ake check.  % su
0860: 64 6f 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 0a  do make install.
0870: 0a 20 4d 6f 72 65 20 64 65 74 61 69 6c 65 64 20  . More detailed 
0880: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 69 6e 63  information, inc
0890: 6c 75 64 69 6e 67 20 6f 74 68 65 72 20 6d 61 6b  luding other mak
08a0: 65 20 6f 70 74 69 6f 6e 73 2c 20 63 61 6e 20 62  e options, can b
08b0: 65 20 66 6f 75 6e 64 0a 20 69 6e 20 74 68 65 20  e found. in the 
08c0: 49 4e 53 54 41 4c 4c 20 66 69 6c 65 20 69 6e 63  INSTALL file inc
08d0: 6c 75 64 65 64 20 69 6e 20 74 68 69 73 20 64 69  luded in this di
08e0: 73 74 72 69 62 75 74 69 6f 6e 2e 0a 0a 0a 52 4f  stribution....RO
08f0: 4c 4c 42 41 43 4b 0a 0a 20 42 65 63 61 75 73 65  LLBACK.. Because
0900: 20 70 77 6d 61 6e 20 69 73 20 69 6e 73 74 61 6c   pwman is instal
0910: 6c 65 64 20 73 65 70 61 72 61 74 65 6c 79 20 66  led separately f
0920: 72 6f 6d 20 73 74 61 6e 64 61 72 64 20 70 61 63  rom standard pac
0930: 6b 61 67 65 20 6d 61 6e 61 67 65 6d 65 6e 74 2c  kage management,
0940: 20 79 6f 75 0a 20 77 69 6c 6c 20 6e 65 65 64 20   you. will need 
0950: 74 6f 20 74 61 6b 65 20 6e 6f 74 65 20 6f 66 20  to take note of 
0960: 74 68 65 20 66 69 6c 65 73 20 6d 65 6e 74 69 6f  the files mentio
0970: 6e 65 64 20 64 75 72 69 6e 67 20 22 73 75 64 6f  ned during "sudo
0980: 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 22 0a 20   make install". 
0990: 61 62 6f 76 65 20 69 6e 20 6f 72 64 65 72 20 74  above in order t
09a0: 6f 20 72 6f 6c 6c 20 74 68 65 20 69 6e 73 74 61  o roll the insta
09b0: 6c 6c 61 74 69 6f 6e 20 62 61 63 6b 2e 20 41 73  llation back. As
09c0: 20 6f 66 20 76 30 2e 34 2e 30 2c 20 74 68 65 73   of v0.4.0, thes
09d0: 65 20 61 72 65 3a 0a 0a 20 20 2a 20 2f 75 73 72  e are:..  * /usr
09e0: 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 70 77 6d 61 6e  /local/bin/pwman
09f0: 0a 20 20 2a 20 2f 75 73 72 2f 6c 6f 63 61 6c 2f  .  * /usr/local/
0a00: 62 69 6e 2f 63 6f 6e 76 65 72 74 5f 70 77 64 62  bin/convert_pwdb
0a10: 0a 20 20 2a 20 2f 75 73 72 2f 6c 6f 63 61 6c 2f  .  * /usr/local/
0a20: 62 69 6e 2f 70 77 64 62 32 63 73 76 0a 20 20 2a  bin/pwdb2csv.  *
0a30: 20 2f 75 73 72 2f 6c 6f 63 61 6c 2f 6d 61 6e 2f   /usr/local/man/
0a40: 6d 61 6e 31 2f 70 77 6d 61 6e 2e 31 0a 0a 0a 42  man1/pwman.1...B
0a50: 45 46 4f 52 45 20 55 53 49 4e 47 20 50 57 4d 41  EFORE USING PWMA
0a60: 4e 0a 0a 20 57 68 69 6c 65 20 63 6f 6d 70 69 6c  N.. While compil
0a70: 61 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 64  ation does not d
0a80: 69 72 65 63 74 6c 79 20 72 65 71 75 69 72 65 20  irectly require 
0a90: 69 74 2c 20 75 73 61 67 65 20 72 65 6c 69 65 73  it, usage relies
0aa0: 20 6f 6e 20 47 6e 75 20 50 72 69 76 61 63 79 20   on Gnu Privacy 
0ab0: 0a 20 47 75 61 72 64 20 28 67 70 67 29 20 62 65  . Guard (gpg) be
0ac0: 69 6e 67 20 69 6e 73 74 61 6c 6c 65 64 2e 20 59  ing installed. Y
0ad0: 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20  ou will need to 
0ae0: 73 70 65 63 69 66 79 20 61 20 47 6e 75 50 47 20  specify a GnuPG 
0af0: 49 44 20 74 68 65 0a 20 66 69 72 73 74 20 74 69  ID the. first ti
0b00: 6d 65 20 61 20 75 73 65 72 20 72 75 6e 73 20 70  me a user runs p
0b10: 77 6d 61 6e 2c 20 73 6f 20 74 68 69 73 20 6d 75  wman, so this mu
0b20: 73 74 20 62 65 20 73 65 74 20 75 70 20 62 65 66  st be set up bef
0b30: 6f 72 65 68 61 6e 64 2e 0a 0a 20 54 68 65 72 65  orehand... There
0b40: 20 69 73 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61   is more informa
0b50: 74 69 6f 6e 20 6f 6e 20 74 68 65 20 67 70 67 20  tion on the gpg 
0b60: 6d 61 6e 70 61 67 65 2c 20 62 75 74 20 79 6f 75  manpage, but you
0b70: 20 63 61 6e 20 70 72 6f 62 61 62 6c 79 20 6a 75   can probably ju
0b80: 73 74 20 72 75 6e 0a 0a 20 20 25 20 67 70 67 20  st run..  % gpg 
0b90: 2d 2d 67 65 6e 2d 6b 65 79 0a 0a 20 61 6e 64 20  --gen-key.. and 
0ba0: 66 6f 6c 6c 6f 77 20 74 68 65 20 6f 6e 2d 73 63  follow the on-sc
0bb0: 72 65 65 6e 20 69 6e 73 74 72 75 63 74 69 6f 6e  reen instruction
0bc0: 73 2e 0a 0a 0a 53 45 54 55 50 0a 0a 20 57 68 65  s....SETUP.. Whe
0bd0: 6e 20 79 6f 75 20 66 69 72 73 74 20 72 75 6e 20  n you first run 
0be0: 70 77 6d 61 6e 2c 20 69 74 20 77 69 6c 6c 20 70  pwman, it will p
0bf0: 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 73 65  rompt you for se
0c00: 76 65 72 61 6c 20 74 68 69 6e 67 73 3a 0a 0a 2a  veral things:..*
0c10: 20 47 6e 75 50 47 20 49 44 0a 20 20 20 54 68 69   GnuPG ID.   Thi
0c20: 73 20 69 73 20 74 68 65 20 49 44 20 6f 66 20 74  s is the ID of t
0c30: 68 65 20 47 6e 75 50 47 20 69 64 65 6e 74 69 74  he GnuPG identit
0c40: 79 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 75  y that will be u
0c50: 73 65 64 20 74 6f 20 65 6e 63 72 79 70 74 20 74  sed to encrypt t
0c60: 68 65 0a 20 20 20 20 70 61 73 73 77 6f 72 64 20  he.    password 
0c70: 64 61 74 61 62 61 73 65 2e 20 59 6f 75 20 63 61  database. You ca
0c80: 6e 20 73 70 65 63 69 66 79 20 74 68 69 73 20 61  n specify this a
0c90: 73 20 79 6f 75 72 20 65 6d 61 69 6c 20 61 64 64  s your email add
0ca0: 72 65 73 73 2c 20 6f 72 20 61 73 0a 20 20 20 20  ress, or as.    
0cb0: 74 68 65 20 38 20 28 68 65 78 29 20 64 69 67 69  the 8 (hex) digi
0cc0: 74 20 6b 65 79 20 49 44 0a 20 20 20 53 65 65 20  t key ID.   See 
0cd0: 68 74 74 70 3a 2f 2f 77 77 77 2e 64 65 77 69 6e  http://www.dewin
0ce0: 74 65 72 2e 63 6f 6d 2f 67 6e 75 70 67 5f 68 6f  ter.com/gnupg_ho
0cf0: 77 74 6f 2f 65 6e 67 6c 69 73 68 2f 47 50 47 4d  wto/english/GPGM
0d00: 69 6e 69 48 6f 77 74 6f 2e 68 74 6d 6c 20 69 66  iniHowto.html if
0d10: 20 79 6f 75 0a 20 20 20 20 61 72 65 20 6e 65 77   you.    are new
0d20: 20 74 6f 20 47 6e 75 50 47 2c 20 61 6e 64 20 6e   to GnuPG, and n
0d30: 65 65 64 20 68 65 6c 70 20 69 6d 70 6f 72 74 69  eed help importi
0d40: 6e 67 20 6f 72 20 63 72 65 61 74 69 6e 67 20 6b  ng or creating k
0d50: 65 79 73 2e 0a 2a 20 50 61 74 68 20 74 6f 20 47  eys..* Path to G
0d60: 6e 75 50 47 0a 20 20 20 50 57 4d 61 6e 20 6e 65  nuPG.   PWMan ne
0d70: 65 64 73 20 74 6f 20 63 61 6c 6c 20 47 6e 75 50  eds to call GnuP
0d80: 47 2c 20 74 6f 20 67 65 74 20 69 74 20 74 6f 20  G, to get it to 
0d90: 64 65 63 72 79 70 74 20 61 6e 64 20 65 6e 63 72  decrypt and encr
0da0: 79 70 74 20 74 68 65 20 70 61 73 73 77 6f 72 64  ypt the password
0db0: 0a 20 20 20 20 64 61 74 61 62 61 73 65 2e 20 53  .    database. S
0dc0: 6f 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 74  o, you need to t
0dd0: 65 6c 6c 20 50 57 4d 61 6e 20 77 68 65 72 65 20  ell PWMan where 
0de0: 74 6f 20 66 69 6e 64 20 79 6f 75 72 20 63 6f 70  to find your cop
0df0: 79 20 6f 66 20 70 67 70 0a 2a 20 50 61 73 73 77  y of pgp.* Passw
0e00: 6f 72 64 20 44 61 74 61 62 61 73 65 20 46 69 6c  ord Database Fil
0e10: 65 0a 20 20 20 54 68 69 73 20 69 73 20 74 68 65  e.   This is the
0e20: 20 66 69 6c 65 6e 61 6d 65 20 74 6f 20 75 73 65   filename to use
0e30: 20 66 6f 72 20 73 74 6f 72 69 6e 67 20 79 6f 75   for storing you
0e40: 72 20 70 61 73 73 77 6f 72 64 20 64 61 74 61 62  r password datab
0e50: 61 73 65 20 69 6e 2e 0a 2a 20 50 61 73 73 70 68  ase in..* Passph
0e60: 72 61 73 65 20 54 69 6d 65 6f 75 74 0a 20 20 20  rase Timeout.   
0e70: 50 57 4d 61 6e 20 6f 6e 6c 79 20 72 65 6d 65 6d  PWMan only remem
0e80: 62 65 72 73 20 79 6f 75 72 20 47 6e 75 50 47 20  bers your GnuPG 
0e90: 70 61 73 73 77 6f 72 64 20 66 6f 72 20 61 20 6c  password for a l
0ea0: 69 6d 74 65 64 20 61 6d 6f 75 6e 74 20 6f 66 20  imted amount of 
0eb0: 74 69 6d 65 2e 20 41 66 74 65 72 0a 20 20 20 20  time. After.    
0ec0: 74 68 69 73 20 70 65 72 69 6f 64 20 68 61 73 20  this period has 
0ed0: 65 6c 61 70 73 65 64 2c 20 79 6f 75 20 77 69 6c  elapsed, you wil
0ee0: 6c 20 6e 65 65 64 20 74 6f 20 72 65 2d 65 6e 74  l need to re-ent
0ef0: 65 72 20 69 74 2e 20 54 68 69 73 20 74 69 6d 65  er it. This time
0f00: 6f 75 74 20 69 73 0a 20 20 20 20 74 68 65 72 65  out is.    there
0f10: 20 61 73 20 61 20 73 65 63 75 72 69 74 79 20 6d   as a security m
0f20: 65 61 73 75 72 65 2c 20 69 6e 20 63 61 73 65 20  easure, in case 
0f30: 79 6f 75 20 77 61 6e 64 65 72 20 6f 66 66 20 66  you wander off f
0f40: 72 6f 6d 20 79 6f 75 72 20 63 6f 6d 70 75 74 65  rom your compute
0f50: 72 0a 20 20 20 20 77 69 74 68 6f 75 74 20 6c 6f  r.    without lo
0f60: 67 67 69 6e 67 20 6f 75 74 2e 0a 0a 20 54 68 65  gging out... The
0f70: 73 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  se configuration
0f80: 20 73 65 74 74 69 6e 67 73 20 77 69 6c 6c 20 62   settings will b
0f90: 65 20 77 72 69 74 74 65 6e 20 74 6f 20 79 6f 75  e written to you
0fa0: 72 20 68 6f 6d 65 20 64 69 72 65 63 74 6f 72 79  r home directory
0fb0: 2e 20 59 6f 75 20 63 61 6e 0a 20 63 68 61 6e 67  . You can. chang
0fc0: 65 20 74 68 65 6d 20 61 74 20 61 6e 79 20 74 69  e them at any ti
0fd0: 6d 65 20 62 79 20 72 75 6e 6e 69 6e 67 20 70 77  me by running pw
0fe0: 6d 61 6e 2c 20 61 6e 64 20 70 72 65 73 73 69 6e  man, and pressin
0ff0: 67 20 27 6f 27 20 61 74 20 61 6e 79 20 74 69 6d  g 'o' at any tim
1000: 65 2e 0a 0a 0a 55 50 47 52 41 44 45 0a 0a 20 43  e....UPGRADE.. C
1010: 75 72 72 65 6e 74 6c 79 2c 20 61 6c 6c 20 76 65  urrently, all ve
1020: 72 73 69 6f 6e 73 20 6f 66 20 70 77 6d 61 6e 20  rsions of pwman 
1030: 75 73 65 20 74 68 65 20 73 61 6d 65 20 65 6e 63  use the same enc
1040: 72 79 70 74 69 6f 6e 20 73 63 68 65 6d 65 20 28  ryption scheme (
1050: 67 70 67 29 20 61 6e 64 0a 20 74 68 65 20 73 61  gpg) and. the sa
1060: 6d 65 20 58 4d 4c 20 66 6f 72 6d 61 74 2e 20 41  me XML format. A
1070: 73 20 73 75 63 68 2c 20 74 6f 20 75 70 67 72 61  s such, to upgra
1080: 64 65 2c 20 73 69 6d 70 6c 79 20 64 72 6f 70 20  de, simply drop 
1090: 69 6e 20 74 68 65 20 6e 65 77 20 62 69 6e 61 72  in the new binar
10a0: 79 2e 0a 0a 0a 47 45 54 54 49 4e 47 20 48 45 4c  y....GETTING HEL
10b0: 50 0a 0a 20 4f 6e 63 65 20 70 77 6d 61 6e 20 69  P.. Once pwman i
10c0: 73 20 72 75 6e 6e 69 6e 67 2c 20 61 6e 64 20 79  s running, and y
10d0: 6f 75 20 68 61 76 65 20 65 6e 74 65 72 65 64 20  ou have entered 
10e0: 79 6f 75 72 20 28 47 6e 75 50 47 29 20 70 61 73  your (GnuPG) pas
10f0: 73 70 68 72 61 73 65 2c 20 79 6f 75 20 63 61 6e  sphrase, you can
1100: 0a 20 68 69 74 20 27 3f 27 20 74 6f 20 67 65 74  . hit '?' to get
1110: 20 75 70 20 74 68 65 20 70 72 6f 67 72 61 6d 20   up the program 
1120: 68 65 6c 70 2e 20 54 68 69 73 20 77 69 6c 6c 20  help. This will 
1130: 74 65 6c 6c 20 79 6f 75 20 77 68 61 74 20 61 6c  tell you what al
1140: 6c 20 74 68 65 20 6b 65 79 73 20 61 72 65 0a 20  l the keys are. 
1150: 74 6f 20 70 65 72 66 6f 72 6d 20 61 63 74 69 6f  to perform actio
1160: 6e 73 20 69 6e 20 70 77 6d 61 6e 2e 0a 20 0a 0a  ns in pwman.. ..
1170: 4c 49 43 45 4e 53 45 0a 0a 20 41 6c 6c 20 66 69  LICENSE.. All fi
1180: 6c 65 73 20 69 6e 20 74 68 69 73 20 64 69 73 74  les in this dist
1190: 72 69 62 75 74 69 6f 6e 20 61 72 65 20 72 65 6c  ribution are rel
11a0: 65 61 73 65 64 20 75 6e 64 65 72 20 74 68 65 20  eased under the 
11b0: 47 4e 55 20 47 45 4e 45 52 41 4c 20 50 55 42 4c  GNU GENERAL PUBL
11c0: 49 43 20 0a 20 4c 49 43 45 4e 53 45 2e 0a 20 53  IC . LICENSE.. S
11d0: 65 65 20 43 4f 50 59 49 4e 47 20 46 4f 52 20 44  ee COPYING FOR D
11e0: 45 54 41 49 4c 53 2e 0a 0a 0a 43 4f 4e 54 41 43  ETAILS....CONTAC
11f0: 54 20 41 55 54 48 4f 52 0a 0a 20 53 65 6e 64 20  T AUTHOR.. Send 
1200: 62 75 67 72 65 70 6f 72 74 73 2c 20 66 69 78 65  bugreports, fixe
1210: 73 2c 20 77 69 73 68 65 73 20 65 74 63 2e 20 74  s, wishes etc. t
1220: 6f 20 4e 69 63 6b 20 42 75 72 63 68 20 3c 63 6f  o Nick Burch <co
1230: 64 65 40 67 61 67 72 61 76 61 72 72 2e 6f 72 67  de@gagravarr.org
1240: 3e 0a                                            >.