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 "17 Jan 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 <password>] [\-S] <filename>
  25
  26 .SH DESCRIPTION
  27 .B pwmc
  28 connects to \fBpwmd\fR and opens \fBfilename\fR. Commands are read
  29 line-by-line from stdin until an EOF occurs. For element values that contain
  30 newline or tab characters, they should be base64 encoded. The
  31 .BR openssl (1)
  32 utility can do this and make the base64 string on one line (base64 -A).
  33
  34 .SH OPTIONS
  35 .TP
  36 .I "\-E"
  37 Exit after a command failure.
  38 .TP
  39 .I "\-s <socket>"
  40 Connect to the specified socket. The default is \fB~/.pwmd/socket\fR.
  41 .TP
  42 .I "\-a"
  43 Use
  44 .BR pinentry (1)
  45 for password retrieval.
  46 .TP
  47 .I "\-p <password>"
  48 Use the specified password.
  49 .TP
  50 .I "\-S"
  51 Send the SAVE command after EOF.
  52 .TP
  53 .I "\-v"
  54 Version information.
  55 .TP
  56 .I "\-h"
  57 Help text.
  58
  59
  60 .SH FILES
  61 .TP
  62 .B ~/.pwmd/socket
  63 Default socket to connect to.
  64
  65
  66 .SH AUTHOR
  67 Ben Kibbey <bjk@luxsci.net>
  68 .br
  69 .URL "http://bjk.sourceforge.net/pwmd/" "PWMD Homepage" .
  70
  71 .SH "SEE ALSO"
  72 .BR pwmd (1),
  73 .BR pinentry (1),
  74 .BR openssl (1)