NEWS

   1 libPWMD v4.0.0
   2 --------------
   3 Fixed gpg-error descriptions. Client's linked to this version of libpwmd
   4 should be using pwmd v0.10 or later.
   5
   6 Made the pwm_t structure private.
   7
   8 Library functions returning PWMD_OK or PWMD_ERROR now are prototyped to return
   9 a type of gpg_error_t. This removes the extra needed parameter when calling
  10 these functions. When these functions succeed, 0 is returned. Otherwise it's
  11 an error code that pwmd_strerror() can describe.
  12
  13 Renamed pwmd_option to pwmd_option_t.
  14
  15 Added PWMD_OPTION_STATUS_FUNC and PWMD_OPTION_STATUS_DATA. The set function
  16 will be called when pwmd sends a status (S) line. The function should return 0
  17 on success or a gpg_error_t which will fail the current command with the
  18 returned error code.
  19
  20 Renamed PWMD_OPTION_[TITLE|PROMPT|DESC] to PWMD_OPTION_PINENTRY_...
  21
  22 When using pinentry for password retrieval, PWMD_OPTION_PINENTRY_TRIES can
  23 be set to specify the number of times before giving up after an invalid
  24 password.
  25
  26 The custom memory de/allocator symbols are now hidden.
  27
  28 Renamed pwmd_password_func to pwmd_password_fn. A pwm_t * is also a required
  29 argument.
  30
  31 Renamed pwmd_status_func to pwmd_status_fn.
  32
  33 Removed pwmd_get_password(). This has been replaced by pwmd_open_nb() and
  34 pwmd_save_nb(). These function's will return a file descriptor that select()
  35 can use when a file isn't cached. When available for a read(), a
  36 pwmd_nb_status_t should be read and then passed to pwmd_open_nb_finalize() or
  37 pwmd_save_nb_finalize() to update the pwm handle. pwmd_open_nb() also has an
  38 option to specify the number of seconds until the pinentry process will
  39 timeout.
  40
  41 Added pwmd_terminate_pinentry() which will kill the pinentry process
  42 associated with the specified pwm handle. Use this if you need a pinentry
  43 timeout but don't call pwmd_open_nb().
  44
  45 Added pwmc command line option -t to specified the pinentry timeout.
  46
  47 When a file ~/.pwmd/env exists, it is read before calling pinentry. This file
  48 contains NAME=VALUE pinentry settings where NAME is one of TTY, TERM or
  49 DISPLAY. These settings will overwrite the ones set by pwmd_setopt(). This
  50 allows a daemon process to use pinentry after it's cache entry has been
  51 removed.
  52
  53 Quite a few API changes and bugfixes. Read libpwmd.3 for details.
  54
  55
  56 libPWMD v3.0.0
  57 --------------
  58 Now uses the assuan protocol for communicating with pwmd. This changes things
  59 quite a bit. Read on...
  60
  61 Uses more secure memory allocation. Kinda. It mainly just zero's out what is
  62 allocated before free()'ing it.
  63
  64 Added pwmd_init(). Call this before anything else.
  65
  66 Added pwmd_open() and pwmd_save(). This removes PWMD_OPEN and PWMD_SAVE.
  67
  68 Removed PWMD_COMMAND. pwmd_command() now accepts a format string as the
  69 command.
  70
  71 Added pwmd_free_result(). Use this to free a result from pwmd_command().
  72
  73 Removed PWMD_SETOPT. Changed to pwmd_setopt().
  74
  75 Added options for setting up the pinentry terminal and display.
  76
  77 Added pwmd_get_password(). This is a nonblocking way of calling pinentry. It
  78 returns a file descriptor that select() can use to read from when a password
  79 is ready to be read from with read() (mostly ripped from Elinks'
  80 start_thread()). Thanks Kalle Olavi Niemitalo <kon@iki.fi> for the idea.
  81
  82 Now uses libgpg-error error codes.
  83
  84 Fixed pwmc and the BYE command.
  85
  86 A few other changes. Read the libpwmd.h header file, libpwmd.3 and ChangeLog
  87 for all the details.
  88
  89
  90 libPWMD v2.0.3
  91 --------------
  92 Split pwmd and libpwmd into their own packages.
  93
  94 Added PWMD_SETOPT options PWMD_OPTION_PASSWORD_FUNC and
  95 PWMD_OPTION_PASSWORD_DATA to specify a custom password retrieval function for
  96 use with the PWMD_OPEN and PWMD_SAVE commands.
  97
  98 gpg-agent(1) is no longer used for interacting with pinentry(1). Now libassuan
  99 calls pinentry directly. This adds PWMD_OPTION_PINENTRY_PATH to specify the
 100 location of the pinentry program. The default is /usr/bin/pinentry. New
 101 programs should use PWMD_OPTION_PINENTRY instead of PWMD_OPTION_USEAGENT and
 102 EPWMD_PINENTRY_ERROR instead of EPWMD_AGENT_ERROR.
 103
 104
 105 libPWMD v2.0.2
 106 --------------
 107 Added a manual page.
 108
 109 Removed pwmd_list_free(). The prototype disappeared but I forgot to remove the
 110 code.
 111
 112
 113 libPWMD v2.0.1
 114 --------------
 115 Restore the working directory after connecting to the socket.
 116
 117 Changed the gpg-agent title and description strings in pwmc.
 118
 119 Fixed a segfault when looking for the empty string in a result from
 120 pwmd_command().
 121
 122
 123 libPWMD v2.0.0
 124 --------------
 125 Most of the PWMD_* commands have been removed. PWMD_OPEN, PWMD_SAVE,
 126 PWMD_SETOPT and the new PWMD_COMMAND remain. PWMD_COMMAND takes a char*
 127 argument being the protocol command along with any argument to send to the
 128 server. This is alot simpler and less error prone than before. Also the
 129 library won't need to be updated if a protocol command changed or is added.
 130
 131 Fixed PWMD_SAVE and asking for a password when the file was cached.
 132
 133 Added pwmc. This is a command line client for pwmd. It reads protocol commands
 134 from stdin.
 135
 136 Removed pwmd_base64_encode() and pwmd_base64_decode().
 137
 138 Added a pkg-config meta file.
 139
 140
 141 libPWMD v1.0.1
 142 --------------
 143 Added PWMD_ATTR_GET to get an attribute value from an element path.
 144
 145 pwmd_base64_decode() bugfix. Don't assume the return value is a character
 146 array by nul-terminating it.
 147
 148 Added pwmd_list_free() to free a "list" result.
 149
 150 Can compile with g++ and maybe other C++ compilers.
 151
 152 Fixed some memory leaks.
 153
 154 Bugfix for the protocol parser.
 155
 156
 157 libPWMD v1.0.0
 158 --------------
 159 Changed the version number as suggested by the libtool docs.
 160
 161 pwmd_base64_decode() bugfix. The returned string wasn't NULL terminated.
 162
 163 Updates for the OPEN and SAVE protocol commands. libPWMD no longer base64
 164 encodes the key.
 165
 166 Updates for the new ATTR protocol command.
 167
 168
 169 libPWMD v0.0.1
 170 --------------
 171 Initial release.