NEWS

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