NEWS

   1 PWMD v2.15
   2 ----------
   3 Fixed the RC_ON_LOCKED and LOCK_ON_OPEN options when opening another file
   4 using the same connection.
   5
   6 Fixed cleaning up the client when it disconnects while waiting for a file
   7 mutex lock. This fixes sending the STATUS_CLIENTS message to other connected
   8 clients rather than having to wait for the next client connect or disconnect.
   9
  10
  11 PWMD v2.14
  12 ----------
  13 Security fix for the key_file configuration parameter. Previous versions used
  14 fgets() to read up to one line of key data. The problem is that it stops
  15 reading at a null byte or a newline character which will truncate your key
  16 data at that byte position. This can be very bad if you think you have secure
  17 randomly generated key data since those bytes can be anywhere in the key file.
  18
  19 The fix is to pay attention to the log message warning about truncated key
  20 data and make note of the byte position. If you were to SAVE the associated
  21 data file and haven't already truncated your key_file to the mentioned byte
  22 position then the next OPEN will fail. You'll can truncate the actual key_file
  23 by doing:
  24
  25         head -c BYTE_OFFSET < key_file > new_key_file
  26
  27 The BYTE_OFFSET is the truncated byte position mentioned in the log message.
  28 Then move the new_key_file to replace the old key_file.
  29
  30 Or you can skip that step and do:
  31
  32         echo DUMP | pwmc datafile > raw_xml
  33
  34 Then do an pwmd XML import (--import) of raw_xml file using a newly generated
  35 key_file (--key-file) which may now contain null bytes or newline characters
  36 without any problems. The 'pwmc' command is included with libpwmd.
  37
  38
  39 PWMD v2.13
  40 ----------
  41 Fixed a segfault in the MOVE command.
  42
  43 Fixed the MOVE command to allow overwriting the destination even if the
  44 destination is a parent of the source.
  45
  46 Fixed a segfault in do_assuan_command() do to an invalid free().
  47
  48 Fixed commands returning GPG_ERR_ASS_WRITE_ERROR when no keepalive timeout was
  49 specified (disabled). Don't create a timeout event. Also changed the timeout
  50 event error code to return GPG_ERR_TIMEOUT.
  51
  52 The default iteration_progress has changed from 0 to 1000.
  53
  54 Fixed a segfault in the COPY command that would get triggered when copying a
  55 tree previously copied and the destination was to a child of the copy.
  56
  57 Changed how the SAVE command handles a specified key when encryption
  58 iterations is 0. Rather than keep the iterations at 0, reset it to the global
  59 iterations settings or 1 if that setting is also 0. Since a key was specified
  60 it is assumed that the file should be encrypted. This prevents misuse and
  61 confusion.
  62
  63
  64 PWMD v2.12
  65 ----------
  66 This version changes how the elements are accessed and breaks data file
  67 compatibility with previous versions. Conversion is done automatically unless
  68 you have elements in your data file name "element" or attributes named "_name".
  69 The reason for the change is that the XML parser doesn't like commonly used
  70 characters in element names (for example, an email address or digit as the
  71 first character). So the solution is to use an attribute to store the name of
  72 the element and let the actual element be generic. All elements in your data
  73 file will be renamed to "element" with an attribute "_name" being the original
  74 element name. Be sure to make a backup copy of your data file. I hope you find
  75 the change worth it.
  76
  77 Fixed creating element paths that had children of the same name as the parent.
  78
  79 Added the MOVE command. This will move an element path to another location in
  80 the document. Faster than a COPY/DELETE.
  81
  82 Added client option RC_ON_LOCKED. If set, rather than sending a status message
  83 when the file mutex is locked, an error code will be sent instead; stopping
  84 the command.
  85
  86
  87 PWMD v2.11
  88 ----------
  89 Another fix for the COPY command. This one fixes copy siblings of the source
  90 element and also fixes references to a free'd pointer.
  91
  92
  93 PWMD v2.10
  94 ----------
  95 Added command XPATHATTR. This will operate on attributes of the expression
  96 nodeset.
  97
  98 XPATH now return GPG_ERR_ELEMENT_NOT_FOUND when the expression doens't match
  99 any elements. It used to return GPG_ERR_NO_VALUE.
 100
 101 ATTR SET no longer requires a value.
 102
 103 GPG_ERR_NO_VALUE is returned from ATTR GET for attributes without a value.
 104
 105
 106 PWMD v2.9
 107 ----------
 108 Don't require libassuan 2.0 anymore. Use the static library included in the
 109 archive like was done before pwmd 2.2. This is needed for use with libpwmd
 110 and fixes a bug with libgpg-error return codes.
 111
 112 Fixed another stupid bug with the RENAME command.
 113
 114 Added SET option LOCK_ON_OPEN to lock the file mutex after a successful OPEN
 115 as if the LOCK command had been sent.
 116
 117 Added the LS protocol command to list files in data_directory.
 118
 119
 120 PWMD v2.8
 121 ----------
 122 Fixed the RENAME command to handle target attributes and ambiguities.
 123
 124 Unicode fixes.
 125
 126 Fixed validating element names.
 127
 128
 129 PWMD v2.7
 130 ----------
 131 Fixed the COPY command to handle root elements and to copy attributes too.
 132
 133 Fixed the RENAME command to overwrite an existing element tree of the same
 134 value.
 135
 136 Since Valgrind and dmalloc don't like PTH threads --enable-debug now prints
 137 out a backtrace of each allocation so finding memory leaks is easier/possible.
 138 The output of xdump() shows non-freed pointers which can be found in the
 139 backtrace output then processed through addr2line to find where it occured.
 140
 141 Fixed a few memory leaks.
 142
 143 Fixed handling of SIGABRT.
 144
 145
 146 PWMD v2.6
 147 ----------
 148 Fixed a nasty bug that may have existed in all previous versions that would
 149 cause a segfault do to an invalid return value from pth_exit().
 150
 151 The default keepalive is now 0 or disabled. It was added during testing of
 152 remote connections over TLS and kept for use with libpwmd and SSH connections.
 153 The development version of libssh2 has connection timeout support so there
 154 really isn't any reason for doing keepalives in pwmd. This also fixes longer
 155 running processes linked with libpwmd that keep a connection open but do not
 156 parse status messages. pwmd would therefore kill the connection.
 157
 158
 159 PWMD v2.5
 160 ----------
 161 New configuration parameter "allowed" to specify which users are allowed to
 162 connect to the unix domain socket. The default is the invoking user only.
 163
 164 Fixed the IMPORT command to let it handle "target" attributes properly.
 165
 166 Let "disable_list_and_dump" be resetable during SIGHUP but only if not
 167 permissive (TRUE).
 168
 169
 170 PWMD v2.4
 171 ----------
 172 Reworked the IMPORT command to let it create root elements. The syntax has
 173 changed to have the content as the first argument and the element path, if
 174 any, as the remaining arguments after the content which is now TAB, rather
 175 than space, separated.
 176
 177 Changed how the "target" attribute value is stored in the document.  Rather
 178 than storing the resolved destination argument, first check to see if the
 179 element path (which may contain other target attributes) is valid then store
 180 the specified path as the "target" attribute value.
 181
 182 A few bugfixes. See ChangeLog for details.
 183
 184
 185 PWMD v2.3
 186 ----------
 187 The DISPLAY and TERM environment variables are unset just before entering the
 188 server loop. Clients wanting to use pinentry must set these options manually
 189 or configure ~/.pwmd/pinentry.conf. This fixes pwmd using these variables
 190 which may no longer be valid.
 191
 192 Ported to libassuan 2.0. There is no longer a static libassuan included in the
 193 archive since this version supports building a DSO.
 194
 195 Fixed the COPY command copying only the the first element of the tree. How'd
 196 that happen?
 197
 198
 199 PWMD v2.2
 200 ----------
 201 Bugfix for pushing non-encrypted files into the cache.
 202
 203
 204 PWMD v2.1
 205 ----------
 206 A new GnuPG key is being used to sign releases and git tags. The new key-id is
 207 0xB140DCE2. The old key-id 0xF2B33BEF should be considered revoked do to a
 208 data loss (not pwmd's fault, though).
 209
 210 Added an "age" attribute to the document element. This attribute is updated to
 211 the time of the last SAVE.
 212
 213 Added support for using different ciphers when saving a data file. This adds a
 214 new configuration parameter "cipher" and also adds a new option "SET CIPHER".
 215 See the manual page for supported ciphers.
 216
 217 Added a new configuration parameter "log_level".
 218
 219 Added the RENAME command to rename an element.
 220
 221 Added the COPY command to copy an element tree to an element path.
 222
 223 Always use the passphrase specified with the OPEN command, if any, even when
 224 the (encrypted) file has been cached.
 225
 226 Fixed converting an unencrypted data file.
 227
 228 A few portability fixes for 64-bit machines.
 229
 230 Added configuration parameter "debug_file" to log all protocol IO to the
 231 specified file.
 232
 233
 234 PWMD v2.0
 235 ----------
 236 This version breaks data file compatibility with previous versions but has an
 237 option to convert your existing data file to the new format. See the manual
 238 page about the --convert command line switch. Future versions that have data
 239 file changes shouldn't have this problem.
 240
 241 Requires a C99 compiler.
 242
 243 libassuan is included statically. There is no longer an external dependency.
 244
 245 Better handling of unexpected client disconnects and status messages.
 246
 247 Added new protocol command VERSION.
 248
 249 Added new protocol commands SET and UNSET. SET replaces the old OPTION
 250 command. UNSET resets an option to its default value.
 251
 252 Pinentry is used when importing, converting and pushing files from the command
 253 line. It can also be disabled to use regular terminal input.
 254
 255 The file cache is a GSList rather than a mmap()'ed page of memory. This allows
 256 for an unlimited number of data files but changes the CACHE status message to
 257 only show the number of cached files and not any total.
 258
 259 Removed EPWMD_MAX_SLOTS, EPWMD_ERROR and EPWMD_ELOOP.
 260
 261 Added new XFER status message. This is sent after every ASSUAN_LINELENGTH
 262 bytes when tranferring data lines. This adds a new configurations parameter
 263 "xfer_progress".
 264
 265 Option ACL (Access Control List) support. When --enable-acl is passed to
 266 configure, data files with an ACL will be retained after a SAVE or inherited
 267 from the data_directory if new.
 268
 269 The ISCACHED command now checks for file existance. Returns GPG_ERR_NOT_FOUND
 270 if it exists but not found in the file cache or an errno from access(2).
 271
 272 Renamed a few SET (old OPTION command) parameters to match the rcfile
 273 parameter names so GETCONFIG will work better:
 274         PINENTRY -> ENABLE_PINENTRY
 275         TIMEOUT  -> PINENTRY_TIMEOUT
 276         PATH     -> PINENTRY_PATH
 277
 278 Removed the old CLIENT option. The old NAME sub-option can be set with SET
 279 NAME=VALUE.
 280
 281 Changed how GETCONFIG handles per-session option changes for some options. If
 282 no file is specified and the specified option was previouly SET, then the SET
 283 value is returned. Else the option for the specified file is read from the
 284 configuration file.
 285
 286 GETCONFIG <filename> ITERATIONS will read the file header of the specified
 287 file. Useful if using a local pinentry and you need to determine if a filename
 288 is encrypted or not.
 289
 290 SET ITERATIONS requires an open file.
 291
 292 The configuration parameters "pinentry_timeout" and "enable_pinentry" can now
 293 be set per-file in the configuration file.
 294
 295 Can now use both short and long command line options.
 296
 297 The CACHETIMEOUT command has had its arguments flipped to keep consistancy
 298 with other commands: CACHETIMEOUT <filename> <seconds>