pwmc.1

   1 .\" This program is free software; you can redistribute it and/or modify
   2 .\" it under the terms of the GNU General Public License as published by
   3 .\" the Free Software Foundation; either version 2 of the License, or
   4 .\" (at your option) any later version.
   5 .\"
   6 .\" This program is distributed in the hope that it will be useful,
   7 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
   8 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   9 .\" GNU General Public License for more details.
  10 .\"
  11 .\" You should have received a copy of the GNU General Public License
  12 .\" along with this program; if not, write to the Free Software
  13 .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  14 .de URL
  15 \\$2 \(laURL: \\$1 \(ra\\$3
  16 ..
  17 .if \n[.g] .mso www.tmac
  18 .TH PWMD 1 "11 Jul 2007" "Password Manager Client" "Password Manager Client"
  19 .SH NAME
  20
  21 pwmc \- send commands to pwmd
  22 .SH SYNOPSIS
  23 .B pwmc
  24 [\-hv] [\-E] [\-s <socket>] [\-a [-P pinentry_path] | \-p <password>] [\-S] [filename]
  25
  26 .SH DESCRIPTION
  27 .B pwmc
  28 is a
  29 .BR libpwmd (3)
  30 client for \fBpwmd\fR. Commands are read line-by-line from stdin until an EOF
  31 occurs. Element values that contain newline or tab characters should be base64
  32 encoded. The
  33 .BR openssl (1)
  34 utility can do this and can also make the base64 encoded string on one line
  35 with the 'base64 -A' switch.
  36
  37 .SH OPTIONS
  38 .TP
  39 .I "\-E"
  40 Exit after a command failure.
  41 .TP
  42 .I "\-s <socket>"
  43 Connect to the specified socket. The default is \fB~/.pwmd/socket\fR.
  44 .TP
  45 .I "\-a"
  46 Use
  47 .BR pinentry (1)
  48 for password retrieval.
  49 .TP
  50 .I "\-P <path>"
  51 The full path of the
  52 .BR pinentry (1)
  53 program. \fBlibpwmd\fP defaults to \fI/usr/bin/pinentry\fP.
  54 .TP
  55 .I "\-p <password>"
  56 Use the specified password.
  57 .TP
  58 .I "\-S"
  59 Send the SAVE command after EOF.
  60 .TP
  61 .I "\-v"
  62 Version information.
  63 .TP
  64 .I "\-h"
  65 Help text.
  66
  67 .SH EXAMPLES
  68 To list the available accounts and use
  69 .BR pinentry (1)
  70 to get the password:
  71 .RS
  72 echo list | pwmc -a filename
  73 .RE
  74 .P
  75 To store an element path and save the file afterwards:
  76 .RS
  77 echo -e 'store isp\\tsmtp\\thostname\\tsomehost.com' | pwmc -S filename
  78 .RE
  79 .P
  80 Clear the file cache for a single file:
  81 .RS
  82 echo 'clearcache filename' | pwmc
  83 .RE
  84 .P
  85 Multiple commands in one instance:
  86 .RS
  87 echo -e 'get isp\\tsmtp\\thostname\\nget isp\\tusername' | pwmc filename
  88 .RE
  89
  90 .SH FILES
  91 .TP
  92 .B ~/.pwmd/socket
  93 Default socket to connect to.
  94 .TP
  95 .B /usr/bin/pinentry
  96 Default location of the pinentry binary.
  97
  98
  99 .SH AUTHOR
 100 Ben Kibbey <bjk@luxsci.net>
 101 .br
 102 .URL "http://bjk.sourceforge.net/pwmd/" "PWMD Homepage" .
 103
 104 .SH "SEE ALSO"
 105 .BR pwmd (1),
 106 .BR pinentry (1),
 107 .BR openssl (1),
 108 .BR libpwmd (3)