NEWS

   1 PWMD v1.4
   2 ----------
   3 Ported to libPth2. This fixes cache locking portability and removes the
   4 --disable-locking configure option.
   5
   6 Added configuration parameter "syslog" to enable logging to the syslog daemon
   7 with facility LOG_DAEMON and priority LOG_INFO.
   8
   9 When the key cache changes send the CACHE status message to each connected
  10 client.
  11
  12 Reuse libgpg-error error codes more often. If your using libpwmd, please
  13 update to the latest version.
  14
  15
  16 PWMD v1.3
  17 ----------
  18 More safety checks when writing the data file after a SAVE command.
  19
  20 Added configuration parameter "socket_perms" to set the permissions of the
  21 created socked overriding any umask setting. May be useful if a client
  22 other than the user who invoked pwmd needs to connect (i.e., ACL's).
  23
  24 Added 'configure' option --disable-locking to disable key cache mutex locking.
  25 Some systems don't have a complete pthread_mutex_t data type which is needed
  26 rather than a pointer (FreeBSD and others probably). Note that using this
  27 option increases the risk of key cache and data file corruption when more than
  28 one client is using pwmd at the same time and save to the same file. If
  29 possible, upgrade your OS and see if this fixes things.
  30
  31 A few bugfixes. See ChangeLog for details.
  32
  33
  34 PWMD v1.2
  35 ----------
  36 Added locking of the file/key cache with certain commands. This prevents other
  37 clients from modifying the cache until the lock is released. This adds a new
  38 pthread compile time dependency.
  39
  40 Zlib version 1.2.2.1 or later is now a requirement.
  41
  42
  43 PWMD v1.1
  44 ----------
  45 Added configuration parameter "recursion_depth". This specifies the maximum
  46 number of times to follow a "target" attribute for a single element. The
  47 default is 20.
  48
  49 When creating a "target" attribute, each element in the element path value is
  50 no longer modified with the literal '!' character at all. You need to specify
  51 the literal instead. This keeps the syntax more consistent with the other
  52 commands.
  53
  54 Added the COMPRESS and DECOMPRESS status messages. Both show the bytes
  55 processed so far, and the total bytes. In order to see the total after
  56 upgrading from a previous version you need to save the data file once.
  57
  58 Changed the PROGRESS status message to ENCRYPT and DECRYPT.
  59
  60 The "disable_mlockall" configuration parameter now defaults to "true". Saves
  61 RAM and is overkill for most since each memory deallocation is cleared before
  62 being freed. The file cache is still locked in RAM though (if possible).
  63
  64 Bugfixes. See ChangeLog for details.
  65
  66
  67 PWMD v1.0
  68 ----------
  69 EPWMD_FILE_NOT_FOUND is no longer used. It is up to the client to determine
  70 if the file exists by using the GETCONFIG command along with 'data_directory'.
  71
  72 The CLEARCACHE command will always succeed (return 0) even if the file is not
  73 found.
  74
  75 A few minor bugfixes.
  76
  77
  78 PWMD v0.12
  79 ----------
  80 Added gettext support. Translations welcome.
  81
  82 Strip the first '!' of a newly created element. If there's a following one
  83 it's an error. This is to avoid syntax errors and confusion with other
  84 commands and element paths.
  85
  86 Only show the number of iterations so far when showing the PROGRESS status
  87 message. The client can get the percentage by calculating the
  88 "iteration_progress" with GETCONFIG.
  89
  90 Fixed a huge memory leak with (de)compression.
  91
  92 The cache status message format has changed to only show the used and
  93 available slots and without any text strings to make it easier for clients to
  94 parse.
  95
  96 SIGUSR1 is caught in the child process. This allows for reloading of the
  97 configuration file.
  98
  99 Fixed pushing files and xml import with compression.
 100
 101 Added --enable-mem-debug to use the standard memory allocators. Valgrind seems
 102 to work better this way.
 103
 104 Fixed a few memory leaks.
 105
 106 Fixed creating invalid XML elements. Elements must not begin with punctuation
 107 or digit and not contain any whitespace.
 108
 109 The output of the LIST command is no longer sorted. Leave it up to the client.
 110
 111
 112 PWMD v0.11
 113 ----------
 114 Added the GETCONFIG command. This will return a value for a configuration
 115 parameter for the opened file or the default value if no file has been opened.
 116 The "key" and "key_file" parameters are ignored.
 117
 118 Rewrote how element handling is done. No longer uses an xmlTextReader but
 119 accesses the xmlDocPtr nodes directly.
 120
 121 The STORE command will no longer overwrite the element tree of the last
 122 element in the specified element path. Instead it will set the content as
 123 usual and keep the child nodes. This affects how GET handles empty elements.
 124 GET will return EPWMD_EMPTY instead of EPWMD_TRAILING_ELEMENT. The STORE
 125 command can also store content in a root element (account) and remove content
 126 or store an empty element by not specifying any content after the last TAB in
 127 the element path.
 128
 129 Each element in an element path can now be prefixed with the literal '!'
 130 character. This allows for following targets of elements other than the root
 131 element.
 132
 133 The LIST command will now shows all reachable elements including target
 134 elements for the specified element path. It also prefixes each element with
 135 the literal '!' when needed.
 136
 137 Added support for compressing data files before encryption. This adds the
 138 "compression_level" configuration parameter. The default is 6 and setting to 0
 139 will disable.
 140
 141 A couple of bug fixes.
 142
 143
 144 PWMD v0.10
 145 ----------
 146 Fixed libgpg-error descriptions. The errors that pwmd uses for bad syntax and
 147 invalid keys etc. used to return an error code that used
 148 GPG_ERR_SOURCE_DEFAULT as the source. GPG_ERR_SOURCE_USER_1 is what pwmd uses
 149 now. This breaks compatibility with clients that make use of the error codes
 150 (i.e., libpwmd). Be sure to update.
 151
 152 Non-option arguments on the command line are files to cache upon startup. This
 153 acts like the 'cache_push' configuration parameter.
 154
 155 The location of the default configuration file is now ~/.pwmd/config and the
 156 default data directory is ~/.pwmd/data, and the default log file ~/.pwmd/log.
 157 This fixes clients opening these non-data filenames.
 158
 159 Fixed default configuration values when an rcfile doesn't have one.
 160
 161 The configuration parameters 'key' and 'key_file' now check to make sure the
 162 key is valid before adding it to the cache like 'cache_push' does.
 163
 164 Clear the file cache and free the memlist on SIGABRT when debugging is not
 165 enabled.
 166
 167 Added command line option -b to fork pwmd to the background.
 168
 169 Added configuration parameter "iteration_progress". pwmd will send the client
 170 a status message showing the percent of iterations that are complete while
 171 encrypting or decrypting a data file. The default is 0 which disables sending
 172 status messages.
 173
 174 Sending SIGUSR1 to pwmd will reload the configuration file.
 175
 176 New protocol command REALPATH. This will resolve any "target" attribute for
 177 all elements in the specified element path and return the result.
 178
 179 Some portability (FreeBSD and maybe others) fixes.
 180
 181 SIGTERM and SIGABRT are now properly caught in a child process.
 182
 183 Bugfixes.
 184
 185
 186 PWMD v0.9
 187 ---------
 188 Now uses the assuan protocol. This requires libassuan and libgpg-error.
 189
 190 Clear the shared memory on exit.
 191
 192 The CACHE sub-commands ISCACHED, CLEARCACHE and CACHETIMEOUT have been made
 193 into their own commands removing the CACHE command itself.
 194
 195 The RESETCACHE command and the cache_reset_timeout configuration parameter
 196 have been removed. The cached files timeout is reset to it's configured value
 197 (or set value with CACHETIMEOUT) after each OPEN or SAVE command.
 198
 199 The OPEN command can open another file using the same connection. Beware
 200 though that if the OPEN of the new file fails, no file will be open at all.
 201
 202 When OPEN'ing a new file with a specified key, cache both the filename and
 203 key. Before you had to SAVE to cache the key.
 204
 205 All commands will check if the file has been modified before continueing. Not
 206 the cache commands though.
 207
 208 Don't unlink() a socket filename that wasn't created by pwmd.
 209
 210 Fixed allocating more slots than needed.
 211
 212 The commands GET, STORE, DELETE and ATTR make use of the "target" attribute
 213 unless the element path argument is prefixed with a '!'. The LIST command
 214 will support "target" in the next release, hopefully.
 215
 216 Accounts names can no longer begin with a '!' character to avoid problems with
 217 the "target" attribute.
 218
 219 Removed EPWMD_ROOT_TEXT_ELEMENT. The STORE command will return
 220 EPWMD_COMMAND_SYNTAX instead.
 221
 222 Added command line option -D and configuration parameter
 223 "disable_list_and_dump". When specified or enabled, the LIST and DUMP protocol
 224 commands will return EPWMD_EMPTY_ELEMENT.
 225
 226
 227 PWMD v0.8
 228 ---------
 229 Use AM_XML2_PATH() for finding libxml2.
 230
 231 Split pwmd and libpwmd into their own projects. Both can be found at
 232 http://bjk.sourceforge.net/pwmd/.
 233
 234
 235 PWMD v0.7
 236 ---------
 237 cache_push and working directory bugfix.
 238
 239 Added two new configuration options "key" and "key_file". Works with
 240 cache_push too.
 241
 242 Added a boolean "cache_reset_timeout" configuration option to reset the timer
 243 for a cached key when the OPEN or SAVE commands are used.
 244
 245 Added two new protocol commands CACHE RESET which clears only the key for the
 246 specified file and CACHE RESETALL which clears the key for all files.
 247
 248 The "name" and "target" attributes are now case-sensitive.
 249
 250 The value of an element path that contains a "target" attribute can be
 251 obtained by prefixing the account element with a '!'.
 252
 253
 254 PWMD v0.6
 255 ---------
 256 Fix for the LIST command. When an element path was specified and the document
 257 had following elements in the tree the following elements would be shown.
 258
 259 Added the CACHE TIMEOUT command to specify the lifetime of a cached file in
 260 seconds. This adds a new configuration file setting "cache_timeout".
 261
 262 Added per-file settings in the configuration file. A file section is declared
 263 by placing the filename in braces. Only the "iterations" and "cache_timeout"
 264 settings are used in a file section.
 265
 266 No longer chdir() to the data directory.
 267
 268
 269 PWMD v0.5
 270 ---------
 271 If a file size is 0 then CACHE ISCACHED will return EPWMD_FILE_NOT_FOUND.
 272
 273 Write a structure to the data file which specifies the iterations and IV. This
 274 lets you open a file that had a different iteration setting than the current
 275 setting. Breaks file compatibility with previous versions for hopefully the
 276 last time.
 277
 278 cache_push with an invalid password bugfix.
 279
 280 Added command line option -I to import an XML file and write the encrypted
 281 data to stdout.
 282
 283
 284 PWMD v0.4
 285 ---------
 286 Use AES-256-CBC to store the data file. This breaks file compatibility with
 287 older versions. Sorry.
 288
 289 The ATTR protocol command has a new GET sub-command to get an attribute value
 290 for an element path.
 291
 292 The LIST protocol command can now take an element path.
 293
 294 The DUMP command will format it's output.
 295
 296 Use MAP_ANONYMOUS|MAP_SHARED mmap() flags on Linux 2.4+. This won't create a
 297 file in /dev/shm. #define MMAP_ANONYMOUS_SHARED in config.h if your OS
 298 supports this.
 299
 300 Fixed closing file descriptors.
 301
 302 Fixed some memory leaks.
 303
 304 The contents of all memory allocated by Glib, libXML and libgcrypt is cleared
 305 before free()ing.
 306
 307 Added an "iterations" configuration parameter. This specifies the amount of
 308 times to encrypt the data to prevent dictionary attacks. Idea borrowed from
 309 aespipe.
 310
 311
 312 PWMD v0.3
 313 ---------
 314 The SETATTR protocol command has been renamed to ATTR. This new command
 315 includes three new sub-commands: SET, DELETE and LIST, to SET or update an
 316 attribute, DELETE to delete an attribute and LIST to list attributes of an
 317 element path. Read PROTOCOL for details.
 318
 319 Added the TARGET attribute. If an element has this attribute set, it's value
 320 is another element path. It's recursive too so the destination element path
 321 can be an element with a TARGET attribute. Be careful of loops though.
 322
 323 Added the DUMP protocol command. It shows the in-memory document. Useful for
 324 cleaning up empty elements that aren't shown with any command.
 325
 326 The "name" attribute can be used in any element but cannot be removed for the
 327 root "account" element.
 328
 329 More strict element name validation for new elements.
 330
 331 Code reorganization. Protocol commands have been put in src/commands.c.
 332
 333 The LIST command won't show element values anymore unless DEBUG was defined at
 334 compile time. You must use the GET command to get a value.
 335
 336 The OPEN and SAVE protocol commands no longer expect a base64 encoded key.
 337 Plain text is where it's at.
 338
 339 The STORE command wont base64 encode the value. We'll leave it up to the
 340 client. But it's still recommended to avoid parsing errors.
 341
 342 All of the command line options have been moved into a configuration file. By
 343 default pwmd will look for it in ~/.pwmdrc. You can use -f to specify an
 344 alternate file. If the file doesn't exist, then some defaults will be used.
 345 There is one new config option though; "cache_push" will take a list of
 346 filenames as an argument. This will prompt for passwords upon startup and add
 347 the file to the cache. It's a (temporary?) fix for background processes that
 348 don't have an attached tty (see libpwmd/KnownBugs). Just make sure the file
 349 the other process needs is added to the cache.
 350
 351
 352 PWMD v0.2
 353 ---------
 354 There is a library included in the archive to make interfacing the pwmd alot
 355 easier. See libpwmd/README for more information.
 356
 357 A (temporary) fix for 100% CPU usage after a client connects.
 358
 359 GnuPG is no longer used for data encryption. Instead, libgcrypt will
 360 encrypt/decrypt the data with AES-128 key. The OPEN and SAVE commands will
 361 need the base64 encoded key.
 362
 363 Renamed host to hostname and added sslfingerprint to the DTD.
 364
 365 Added command line option -s to specify the socket path.
 366
 367 Added command line option -d to specify where pwmd will open and save the data
 368 files.
 369
 370 Renamed protocol command SET to SETATTR.
 371
 372 Added shared memory file caching. If a file is found in the cache then the
 373 cached password associated with the file will be used with the OPEN command.
 374 With SAVE, if there is no cached password a key is required, else the cached
 375 password will be used unless there is a key argument. This also adds a new
 376 protocol command CACHE with 3 subcommands CLEARALL, CLEAR and ISCACHED.
 377 Sending the SIGHUP signal to pwmd will clear the file cache.
 378
 379 Added command line option -M to disable calling mlockall(). mlock() will still
 380 be used for the file cache reguardless of this option.
 381
 382 Added command line option -C to specify the file cache size. The cache size
 383 must be in multiples of PAGE_SIZE.
 384
 385 Added command line option -l to enable logging to the specified file.
 386
 387 If there is a protocol command error, ERR is returned along with a protocol
 388 error code and description. See src/pwmd_error.h for error codes.
 389
 390 Fix for the DELETE command and deleting an entire element tree when an invalid
 391 element was in the element path.
 392
 393 Fix for the GET command and finding elements of the same name in other
 394 accounts.
 395
 396 Added a manual page.
 397
 398
 399 PWMD v0.1
 400 ---------
 401 Initial release.