1 Release: version 0.13 - 2008/05/??
2 ------------------------------------------------------------------------------
4 - updated doc/TroubleShooting.txt
5 - removed usb_control message check from IpModem endpoint probing
6 in src/probe.cc, since some devices, like the 8700
7 have both RIM_UsbSerData mode and IpModem mode.
9 - applied Jason Thomas's ACLOCAL_FLAGS patch to make autoreconf
11 - applied Jason Thomas's debian build dependency patch
14 - started documentation overhaul in doc/www, putting the commonly
15 asked questions right on the front page, and making it more
16 goal-oriented, so it is hopefully easier to use
19 - fixed error messages in m_desktop.cc that still referred
22 - major merge of barry-b1-socket-arch-branch into MAIN.
23 The following is the changelog from that branch, which is now MAIN.
26 - added thread-safe logging mechanism
27 - added preliminary IP modem support... requires a recent
28 device... serial mode is not yet supported
31 - changed Barry::Init() so programmer can choose where
32 debug and exception information goes, instead of
37 - fixed bug in probe class, which missed storing the PIN
39 - also added ProbeResult constructor
40 - merged changes from visibility branch:
41 - GCC visibility support, limiting what symbols are
42 visible in the shared library, libbarry... this makes
43 a drastic reduction in the symbol table, and should
44 avoid future name clashes with other libraries such
46 See: http://gcc.gnu.org/wiki/Visibility
47 - vformat_() function name changes
50 - added threads library to new bs11nread build
52 - fixed variable size issues in btranslate.cc, evident with
53 some compilers on 64 bit systems
55 - added comments for threaded usage in usbwrap.h
56 - changed router to use SocketId typedef, for clarity
58 - fixed const char warnings from newer gcc compilers
59 - controller object now saves a copy of the probe result
60 and provides an API to retrieve it
61 - added sanity checks to m_serial.cc
62 - fixed probe behaviour so that a USB probe on an endpoint
63 that doesn't respond won't halt everything
64 - refactored some of the probe code, and added checks for
66 - added Probe::DumpAll()
67 - added Open() call to pppob.cc (not yet complete)
69 - implemented dataqueue.{h,cc}... looks ready for testing,
70 once things compile again
71 - changed free list copy in router.cc to use
72 DataQueue::append_from()
73 - finished packet.{h,cc} implementation, ready for testing
74 - finished controller.{h,cc}, ready for testing
75 - finished m_desktop.{h,cc}, ready for testing
76 - added skeleton m_serial.cc
77 - the base library and utilities compile again!
78 - added constructor for SocketZero(queue)
79 - fixed ErrnoError::GetMsg()
80 - updated GUI and opensync plugin to compile with new API
81 - moved Raw Send/Receive socket functions to private
82 - fixed packet header size bug in socket that caused
83 socket ID override to be skipped
84 - fixed incorrect use of gettimeofday()
85 - fixed race condition where Controller could destroy
86 the Usb::Device object before the SocketRoutingQueue
88 - fixed segfault in SocketZero::RawSend() when a router
90 - fixed Open() bugs in btool... Open() must be outside of loops
91 - btool uses the router thread now, for testing
92 - partially implemented m_serial.{h,cc}... needs testing
93 - added automatic buffer allocation to SocketRoutingQueue
95 - made AllocateBuffers() a little smarter, so it was not
97 - added a context data pointer to the SocketRoutingQueue
98 RegisterInterest callback
99 - added RegisterInterest functionality to Socket class
100 - added exceptions on router read errors in socketzero
102 - implemented router.{h,cc}... looks ready for testing,
103 once things compile again
105 - merged HEAD changes
106 - added router.cc and continued work on new arch
107 - merged HEAD changes for 2008 copyright statements
108 - added scoped_lock.h
109 - added ErrnoError exception class
110 - documented Controller / SocketRoutingQueue behaviour
111 - more router implementation
113 - audit and cleanup of socket.{h,cc} code... looks ready
114 for testing now, once things compile again
115 - removed FIXME in router.*
116 - removed pthread header from pppob as it is not needed
118 - merged HEAD changes
120 - merged HEAD changes
122 - branch started, to track development of the new socket
123 architecture, and new mode architecture, needed
124 to support GPRS modem support, and threaded
126 - committed work-in-progress... does not compile
129 - added Tasks and Memos to TODO list
131 - added support for Blackberry 8120, which has a unique Product ID
132 Sourceforge tracker ID: 1829537
134 - removed TimeZones from TODO list, as it is done
140 - gui/src/BackupWindow.cc
144 - opensync-plugin/src/barry_sync.cc
145 - added GCC visibility support, limiting what symbols are visible
146 in the shared library, libbarry... this makes a drastic
147 reduction in the symbol table, and should avoid future
148 name clashes with other libraries such as opensync
149 See: http://gcc.gnu.org/wiki/Visibility
151 Release: version 0.12 - 2008/03/21
152 ------------------------------------------------------------------------------
154 - changed maintainer script to use CVS export instead of checkout,
155 to avoid the CVS directories
156 - added support for building Debian source packages with proper
157 diff.gz and dsc files
158 - fixed find warning in maintainer/make-rpm.sh
159 - added support for Ubuntu binary packages to the maintainer build
162 - renamed all vformat_ and VFormat symbols in opensync plugin's
163 copy of vformat code, so they don't conflict with the
164 real opensync libraries
166 - updated the install.php web page with Paul Dugas's notes on
167 building RPM's from CVS
168 - fixed problem in tools/Makefile.am where bs11nread was included
169 in build, even if --with-boost was not specified
170 on ./configure command line
172 - changed format of Boost serialization file output from btool,
173 so that the database name is stored as the first line
175 - added tools/bs11nread.cc to read Boost serialization file data
177 - minor adjustments to r_message.h and r_timezone.h
178 - updated s11n-boost.h header to match record classes
180 - applied Time Zone parsing patches from Brian Edginton
181 - added Time Zones to list of supported parsers in btool.cc
183 - changed configure.ac to use bzip2 for "make dist".. thanks to
184 Paul Dugas for the tip
186 - committed Chris Burgess's update to the roadmap document
187 - applied Paul Dugas's x86-64 build patch, except the
188 tar.bz2/tar.gz change
189 - updated AUTHORS file
191 - fixed configure.ac's --with-boost option, so that without args,
192 it defaults to using --includedir and --libdir settings,
193 instead of hardcoding /usr/include and /usr/lib... this
194 should allow smarter compiling on 64 bit systems
195 - updated RPM spec file to use new --with-boost behaviour
196 - ahem, fixed configure.ac again... don't use --includedir and
197 --libdir, as those are install targets... oops.
198 Don't add path overrides at all if not specified.
200 - fixed locale issues in src/data.cc
201 - updated copyright statments for 2008
203 - applied wording correction patch to btool from Matt LaPlante
205 - changed hard coded databases names in btool to calls to
206 <recordclass>::GetDBName()
211 - gui/src/BackupWindow.cc
215 - opensync-plugin/src/barry_sync.cc
218 Release: version 0.11 - 2007/12/01
219 ------------------------------------------------------------------------------
221 - fixed null pointer bug in Probe class (bug #1842407)
222 - added pause to maintainer release script
228 - gui/src/BackupWindow.cc
232 - opensync-plugin/src/barry_sync.cc
234 Release: version 0.10 - 2007/11/30
235 ------------------------------------------------------------------------------
237 - added support to the usbwrap Match class to limit its
238 search by busname / devname
239 - added support to the Probe class to limit its search for
240 Blackberry devices to a given bus or device name
241 - added command line options to btool for the above Probe
242 bus/device names, and updated the man page
243 - updated the www docs with regard to the new usb_storage
244 behaviour and the new blacklist files... less
245 concern about berry_charge and usb_storage conflicts
246 - added bidentify tool and accompanying man page
247 - fixed bug in rpm maintenance script that used the wrong
248 spec file for opensuse
250 - added better error checking to breset
251 - commented the sleep() for the 8830
252 - added code to handle the race condition where usb_storage
253 claims the device before bcharge arrives on the scene,
254 by asking the kernel to detach the driver from
255 the Mass Storage interface... this change makes it
256 possible to run bcharge, moving from 0006 to 0004
257 to 0001 and back to 0004, all *while* usb_storage
259 - changed Probe class behaviour so that it will not throw an
260 exception on Device Busy (-EBUSY) but instead
261 log the error in an internal array and keep going.
262 This makes it possible to use btool and barrybackup
263 with two devices plugged in at the same time.
264 BACKWARD COMPATIBILITY NOTE: this changes initializaion
265 behaviour, but in practice, it should only
266 make applications look more capable, not less.
267 - updated btool to show errors logged by Probe
268 - added message to specify which PIN device is being used by btool
269 - added explanatory comments to udev rules files, about why
272 - added ClearHalt() calls to probe and controller classes, just
273 before any communication happens... the 8830 seems
276 - added usbwrap.cc:GetConfiguration()
277 - added code to check whether the configuration is the one
278 we require, before calling SetConfiguration()... and not
279 to call it if unnecessary. This allows us to run
280 at the same time as usb_storage.
281 Thanks to Martin Owens for not letting this issue go. :-)
282 - added sleep to bcharge, before calling usb_reset()... the
283 Blackberry 8830 behaves like a Pearl device in that
284 it has mass storage support, but behaves like a Classic
285 in that it resets itself... the usb_reset() seems
286 to reset it back to 0006. The sleep allows the device
287 to disappear via its own reset, and let usb_reset()
288 fail naturally on these devices.
289 This is not an ideal solution... mainly for testing.
291 - added modprobe/blacklist-berry_charge as per Simon Ruggier's
292 suggestion. Thanks also to Niels de Vos for a similar
294 - fixed udev rules to work on both old and new distros
295 Thanks to Duncan Mak for the bug report.
297 - fixed string comparison to use case insensitive compare in
299 - updated Debian package to include modprobe blacklist file
300 - updated rpm spec file to include modprobe blacklist file
301 - split the maintenance scripts into release and test, so
302 that release package builds can be done faster
304 - opensync plugin fixes:
305 - fixed memory leak in vBase::GetAttr()
306 - added support in vformat parser to parse "blocks"
307 and keep track of the hierarchy when
308 parsing an iCalendar, etc.
309 - added support for searching for attributes only
310 inside certain blocks (i.e. find first
311 DTSTART in VEVENT block, not VTIMEZONE block)
313 - fixed bug in Calendar::Clear, missing the Free / Class
314 member variables, leaving them uninitialized
315 - added examples/addcalendar.cc
316 - added more logging to the opensync plugin, logging the
317 ToBarry conversion results
318 - added code to force struct tm.tm_isdst to -1 before calling
320 - fixed typo in previous fix
322 - renamed ktrans and translate to bktrans and btranslate to avoid
323 file name clashes with libtranslate of Gnome
324 Closes bug #1812410 reported by Troy Engel.
329 - gui/src/BackupWindow.cc
333 - opensync-plugin/src/barry_sync.cc
334 - fixed missing default config file in the debian package for
336 Closes bug #1812224 reported by Ariel (adonatti).
337 - added debian dbg packages for tracing segfaults
338 - modified maintainer scripts so debug packages would reference
339 source code located in /usr/src/barry-0.9, etc.
341 Release: version 0.9 - 2007/10/12
342 ------------------------------------------------------------------------------
344 - adjusted autosuspend disabling code in bcharge, based on new
345 information on how kernels 2.6.21 / 2.6.22 work.
346 See bcharge.cc for comments. If device/power/level or
347 device/power/autosuspend exist, charging should now work
348 without recompiling the kernel.
349 - updated website docs with autosuspend info
351 - large update to the doc/www web pages, moving some of the
352 information in README files to html format, so that it
353 is commonly available on the web
354 - added step in maintenance scripts to automatically build the
355 .html files in doc/www when making a tarball release
357 - added libopensync 0.22 version requirement to barry.spec file,
358 but it doesn't seem to work on OpenSuSE 10.2, where it's
361 - updated README to mention new tree build configure options
362 - fixed the configure scripts and makefiles so that when building
363 with custom CXXFLAGS and LDFLAGS environment variables,
364 it doesn't break the full-tree build mode, when
365 using --enable-gui and/or --enable-opensync-plugin
366 - added config.h.in~ to buildgen.sh clean target
367 - converted Debian build scripts to use cdbs
368 - added opensync plugin binary package for Debian
369 - added "Getting Started" section to web pages, as well as an
370 explanatory document for various system requirements
371 - turned on opensync build in RPM maintainer scripts
373 - added filename to power/state error message in bcharge.cc
374 - adjusted maintainer scripts to automatically adjust barry.spec
375 for opensuse rpm builds
377 - fixed some of the release build scripts and added support for
378 automated opensuse 10.2 builds
379 - fixed build target to i386
380 - changed scripts to add to PKG_CONFIG_PATH variable instead
383 - added website docs to doc/www... these are out of date at the
384 moment, and hopefully by including them here, they
385 will be updated more frequently
387 - applied Simon Ruggier's build system patch that allowed a build
388 of all 3 components from the root directory and fixed the
389 configure scripts to support external build directories
390 - reordered clean commands in the buildgen.sh scripts, and removed
391 the INSTALL files, since they are auto-generated by autoconf
392 - removed extraneous buildgen.sh calls in maintainer scripts
393 - added Simon Ruggier to AUTHORS
394 - added explanatory note to 3 stage test build process in
397 - fixed Category handling in the Contact record class, to
398 parse the comma separated string into an array,
400 Note: this involves a change to the boost serialization
401 and will affect backward compatibility with
402 old serialization datafiles
403 - added Category to examples/addcontact.cc
404 - added Category support to the opensync plugin
406 - fixed wrong read/write in btool output (oops)
407 - added BadSize exception, and changed CheckSize() function
409 - changed backup GUI to catch BadSize exceptions on initial
410 connect, and try a reset if that error occurs, since
411 that likely means the device didn't shutdown properly
412 - fixed in opensync plugin:
413 - some vcard data contains types codes in capital letters,
414 so added lower case conversion routine
415 - changed the order of address lines, so that address1
416 is the street, address2 is the extended address,
417 and address3 is the PO Box. The Blackberry
418 doesn't seem to have any PO Box field.
420 - added -e endpoint override option to btool
421 - added status message to endpoint override
423 - added configure check for strnlen, and implementation for
424 systems that don't have it, or that have it implemented
425 incorrectly. Went a little paranoid here, since
426 AC_FUNC_STRNLEN doesn't set a define in config.h,
427 so I had to do it manually, and check in case autoconf
428 changes in the future... ugh. See src/strnlen.h for
430 - added code in probe.cc to fetch the device's description.
431 The description is now part of the probe results
432 along with the PIN. Updates to protocol.h, adding
433 a new attribute definition.
434 Thanks to Rick Scott for pointing out the code in
435 XmBlackberry where he implemented this first.
436 - fixed header dependency in record-internal.h
437 - updated the "required autoconf" version to 2.61 for root build
438 - moved nested structs out of the record classes that contain them,
439 in order to better support SWIG and Python
441 - changed bcharge to use getopt() for its argument processing
442 - added options -p and -s to bcharge, to adjust usb suspend
443 settings automatically where possible
444 - updated the udev rules to use the new bcharge settings
445 - updated the bcharge man page with the new arguments
447 - cleaned up Usb exception handling, moving libusb error code
448 processing into the Usb::Error exception class.
449 error.cc is now an empty shell
450 - added return codes to the Usb::Error exceptions
451 - removed aboutdialog.{h,cc} from the backup GUI since even
452 Debian stable now has up-to-date gtkmm libraries
453 - added more user friendly error message for the "device busy"
454 case, recommending 'rmmod usb_storage'.
456 - added better error checking to bcharge.cc
461 - gui/src/BackupWindow.cc
465 - opensync-plugin/src/barry_sync.cc
466 - removed usb_set_configuration() check from bcharge.cc, since
467 that may fail under normal operation, in this case
469 Release: version 0.8 - 2007/08/03
470 ------------------------------------------------------------------------------
472 - moved Interface implementation to usbwrap.cc file
473 - added dout debugging messages to usbwrap.cc
474 - clarified unhandled packet error message in socket.cc
475 - added temporary workaround in opensync-plugin environment's
476 Reconnect(), for odd message seen on newer Blackberry
478 - fixing issues with Brian Edginton's MessageRecord patch (2007/06/29)
479 - fixed missing size check in message oriented ParseHeader()
480 - fixed endian conversion issues (also found one pre-existing
481 endian bug in the process)
482 - moved message timestamp converter code to time.cc
483 - added Barry version number to opensync plugin name
484 - changed maintainer scripts and rpm.spec to use bzip2 instead of gzip
485 - added opensync-plugin to configure script build
486 - added -S option to btool, to list supported parsers and builders
487 - slight change to opensync-plugin/buildgen.sh to cleanup config.h.in~
488 - opensync-plugin/README update
489 - added opensync-plugin/patches for others who may be building and
490 testing the plugin with OpenSync 0.22
491 - added debian package build scripts to maintainer/
493 - added entry to doc/TroubleShooting.txt
495 - added doc/TroubleShooting.txt
498 - fixed bug in vcard.cc that was using the FN field
499 for the broken-down name instead of N
500 - added dbId and dbName to DatabaseSyncState
501 - added Reconnect() functionality to BarryEnvironment class
502 and moved connect logic out of barry_sync.cc
503 - changed the batch commit functionality in barry_sync.cc
504 to single-change-commit. Why? Because opensync
505 0.22 groups all batch changes into one group
506 and calls one batch commit function, even if you
507 registered two. Moving to single change commit
508 mode removes a chunk of unneccessary code
509 from the plugin as well, and can in theory
510 ease memory pressure in the library.
511 - added FinishSync() to perform actions needed on successful
513 - disconnect on successful sync completion, and reconnect,
514 since the device's dirty flags don't seem to
515 be updated until a disconnect occurs.
517 - added ReadDataArray() to data.h, using an istream instead of
519 - added raw data version of BuildField() to record-internal.h
520 This is so that btool doesn't add extra null terminators
521 to unknown data, when restoring with option -s
522 - fixed bugs in r_contact.cc:
523 - fixed bug that caused a LastName/FirstName swap
524 if FirstName was empty and you wrote a contact
525 record into the device.... First/Last Name
526 fields are position sensitive, and the code
527 was missing the empty FirstName case on writing
528 - fixed bug in BuildFields() and Dump() where they
529 were not updated to handle the new field
530 table added for the postal address changes
533 - changed the plugin config file, so it is possible to
534 turn debug output on/off without recompiling
535 - moved the standalone Map2Uid() function into
536 the DatabaseSyncState class, and changed the
537 code to produce "contact-#" and "calendar-#"
538 UID strings, instead of just numbers
539 - changed default PIN to -1, so that if the user doesn't
540 configure properly, it will fail... this is a
541 safety measure to avoid syncing with different
542 devices and corrupting the cache/idmap...
543 this should be fixed someday, to handle this
545 On second thought... is this right? Perhaps
546 it is better to fail if the PIN is not what
547 is expected, so a user doesn't accidentally
548 sync the wrong device and lose data.
549 Actions to take on new PIN:
550 - force slow_sync, or
552 - incorporated the new VCardConverter code into the
553 main barry_sync.cc plugin code
554 - fixed bug that did not clear the devices dirty flags
555 in the case where a sync only read data from it,
557 - changed PIN error message number to hex
559 - minor wording change in backup GUI prompt: "Backup working..." to
560 "Backup in progress..."
561 - renamed Contact class's Title field to JobTitle for clarity
562 - added record function ParseFieldString(), which properly handles
563 strings from the device that have multiple null terminators,
564 and changed the record parsing code to use this new function
565 - moved FullName() function from ldif.cc to r_contact.cc since it
566 is generally useful in areas outside of LDIF processing
567 - refactored postal addresses in the Contact record class into
568 a new class called PostalAddress
569 - renamed Address class in record.h to EmailAddress
570 - moved Contact::GetPostalAddress() to record.cc as part of the
571 new PostalAddress class and renamed it
572 PostalAddress::GetLabel()
574 - refactored vformat helpers into separate base class
576 - added vCard converter class
577 - commented out the code that skipped over the adding
578 of empty attribute values and parameters,
579 since VCARD depends on some of this behaviour
580 - movified vformat.c:vformat_find_attribute() to take
581 an extra nth argument, in order to search
582 for multiple attributes with the same name...
583 the way this is coded is a bit inefficient...
584 but we're moving away from vformat when we move
585 to OpenSync 0.3x / 0.40, so this is just temporary
588 - added SUBSYSTEM=="usb_device" to example udev rules, in order
589 to avoid running bcharge for each endpoint that is
590 added by udev, when first plugged in. Running bcharge
591 back-to-back multiple times can crash some
595 - fixed ID mapping bug in the case of a non-numeric UID
596 from syncing external -> Barry, and then the
597 new Barry ID would look like a new change
598 when syncing back from Barry -> external.
599 - added support for slow sync
600 - added clear() to idmap class
601 - added vformat attr parameter extraction class
602 - added more trace logging during vformat/Barry conversions
603 - added Notification time support
604 - handled "all day" vformat special case, when DTEND
605 does not exist in a vformat data block
606 - changed the min1900_t time conversion functions to handle
607 the 0xffffffff special case, when notifications
608 are turned off on a calendar event (src/time.cc)
609 - also made the calendar data dump output clearer for
610 disabled timestamps, and added debug output
611 for the raw min1900 value, in case there are more
612 special cases in the future
614 - fixed null pointer access in opensync's HasMultipleVEvents()
616 - upper management directive: revert all OpenSync 0.3x changes
617 and proceed with OpenSync 0.22. Reverting the
618 opensync-plugin/src tree to Barry 0.7 status.
620 - reorganized exception and trace code in opensync plugin
621 - added XmlToCalendar() function, based on unfinished opensync
622 library API that is not yet finished... will be
623 committed to opensync svn tree when complete
624 - added OSyncXMLField logger to plugin trace class
626 - applied email MessageRecord patch from Brian Edginton (thanks!)
627 - updated Message::Dump() to output more valid mbox data...
628 the goal is to be able to do:
629 btool -d "Messages" > email.mbox
631 - changed some TODO's to FIXME's to keep it grep-consistent
632 - applied Folder support patch from Brian Edginton
633 - fixed pedantic compile warnings, and changed order in src/Makefile.am
634 - removed unneeded cast in src/r_folder.cc
636 - minor adjustment to ctags building in buildgen.sh
637 - applied patch from Brian Edginton for better boost detection
639 - added boost usage message to btool -h output
641 - more porting of OpenSync module to 0.30
642 - added ctags build for opensync source tree to buildgen.sh
644 - changed PKG_CONFIG_PATH setting in rpm script, so that systems
645 like SuSE that have an extensive PKG_CONFIG_PATH
646 in general use will not break on build
647 - added PKG_CONFIG_PATH to debian script too, just in case :-)
648 - added debian/changelog to doc/ReleaseChecklist.txt
649 - added comment to rpm/barry.spec regarding SuSE RPM builds
651 - applied patch from Niels de Vos fixing debian package build
653 - applied Brian Edginton's Saved Email Messages patch
654 - updated r_saved_messages.cc comment to match header
655 - added GetRecType()/GetUniqueId() to r_saved_messages.h, since
656 SetIds() is already there
657 - removed Address version of operator<<() from message related headers
658 and moved into record.h
659 - added std::hex to message related dumps, and changed output to
661 - updated doc/CodingStyle.txt to cover switch() statements
662 - opensync compiles again, with 0.30! (not functional yet)
663 - moving closer to more modular and reusable plugin functions
664 - updated release checklist for opensync version number
666 - added doc/CodingStyle.txt... preliminary version
668 - applied Brian Edginton's PIN message patch
669 - changes to PIN message patch:
670 - fixed missing backslash in src/Makefile.am
671 - fixed tab alignment throughout
672 - removed typedef from Address struct
673 - added clear() to Address... might as well, if it it is
674 going to be a standalone type
675 - fixed missing comma in PINMessageFieldLinks table
676 - changed MessageRecordId in PINMessage to load from a new
677 uint32_t field in CommonField, instead of piggy
678 backing on a field for other use
679 - did some testing and found that PINMessage's MessageRecordId
680 is the same as the RecordId given through the SetIds()
681 API... but these Id's are duplicated in the protocol...
682 RecordId is stored in the protocol header, while
683 MessageRecordId is stored in the record it self as
684 a common field... added RecType and RecordId to
685 PIN Message so that we store both of these
688 - added item to gui/TODO
689 - applied Brian Edginton's s11n-boost.h patch
691 - renamed template values to more consistent naming scheme
692 - applied memos and tasks patch from Brian Edginton, slightly
693 modified to split into the new separate files system
694 - changes to memos and tasks classes:
695 - reformatted the code to match coding style
697 - added copyright notice
698 - changed class to singular (Memo, not Memos)
699 - placed in Barry namespace
700 - added #ifdef header protectors
701 - added new files to Makefile.am
702 - added new r_*.h headers to record.h
703 - added support for Memos and Tasks to tools/btool.cc, based on
704 Brian Edginton's patch
705 (currently commented out, for Boost library reasons):
706 - added doc/CommitPolicy.txt
709 - added ctags generation to buildgen.sh
710 - applied record.{h,cc} fix patch from Brian Edginton
714 - fixed broken formatting in above patch
715 - refactored record parser classes into separate files for each
716 - changed the ConvertHtoB<> template to inline, as it caused
717 linker errors with the new file layout
719 - fixed bug in Debian packaging that put util commands in
720 /bin and /sbin instead of /usr/bin and /usr/sbin
721 - commited byteswap.h replacement code from gm2net
723 - removed unneeded debug messages on stdout
724 - changed the default for debug output to "off"
725 and added a command line option to turn
726 it on if necessary (--debug-output)
727 - command line option --help now also works
728 - fixed bug in Calendar class where it didn't initialize
729 RecType properly... and cleaned up other RecType
730 code to use the GetDefaultRecType() functions,
731 localizing the constants in one place
733 - applied patches from Brian Edginton, parsing more
734 fields in Contact and Calendar records
735 - added Brian Edginton to AUTHORS
736 - reformatted record.{h,cc} to match the rest of the code,
737 removed commented out code, and removed mention of
738 Outlook from the comments.
739 - updated udev/10-blackberry.rules.Debian for Debian Etch
740 - updated debian/rules to use new udev rules file
741 - removed debian/postinst, as stable versions of Debian now
742 have a recent udev, and don't need the special handling
743 - updated Debian build scripts to build separate packages:
748 - added menu support to Debian barrybackup-gui package
749 - made the buttons bigger in the backup GUI, as they were too
752 - more progress in porting to opensync 0.30, heavily
753 based on the example plugin in the opensync
754 svn tree... this is a work in progress, and so far
758 - partial porting to opensync 0.30 (in progress!)
759 - fixed bug in sync_done where it reported context error
760 and then success afterward
761 - checking in new INSTALL files based on Etch's autoconf run
762 - added item to gui's todo list
763 - bumped version numbers to 0.8 in:
767 - gui/src/BackupWindow.cc (about dialog)
771 Release: version 0.7 - 2007/05/02
772 ------------------------------------------------------------------------------
774 - added rpm building to maintainer/release scripts
775 - added "HEAD" feature to tarball creation script, for easier testing
776 - updated maintainer/README
777 - updated maintainer/release.sh to use new HEAD feature too
779 - added pppob to rpm barry.spec
780 - bumped release number in barry.spec
783 - fixed size check bugs (strlen() == 0 when empty)
784 - finished refactoring calendar conversion routines
785 - started timezone parsing, but this may go away
786 if we use opensync 0.30's time functions and
788 - added development note to README
790 - updated README and opensync-plugin/README with more current
793 - refactored some calendar conversion routines
794 - added Barry->vCalendar conversion for recurring appointments
797 - removed some unneeded trace logs
798 - fixed VEventConverter constructor bug, with uninitialized
800 - eased up the requirement that every calendar event
801 must have a summary... defaults to "<blank subject>"
803 - added more VCALENDAR fields to match Barry::Calendar record
804 - fixed case sensitive compares in vformat.c
806 - opensync module work:
807 - added id map class to map string uid's from OpenSync to
808 numeric ID's from the Blackberry
809 - fixed bug in CommitChange() where it was still using
810 a hard coded calendar record state table
811 - added lots of logging throughout
812 - fixed bug where newly added records didn't use the
813 change object's uid, but created a new ID,
814 causing another sync on the next run
815 i.e. (CommitData_t was missing an argument)
816 - fixed bug where uninitialized notification time was
817 written to the Blackberry
818 - more opensync module work:
819 - refactored the environment class into another subclass
820 called DatabaseSyncState, and moved some stand-
821 alone functions from barry_sync.cc into
822 the environment classes
823 - added a tagged constructor to the trace class
824 - fixed idmap::Load() to clear map before loading
826 - renamed barry-config to barry-sync, the default configuration
827 file for the opensync module... and filled it with
828 a sample configuration
829 - added code to update the calendar cache, and write it to disk
830 on success (opensync module)
831 - added code to clear dirty flags in the device (opensync module)
832 - allowed comments in the config file
833 - added vformat.c from libopensync 0.22, since the vformat
834 routines are not available from the plugin side
837 - added -d switch to bcharge to switch back from 0001 to 0004 mode,
838 changed the auto-detection logic to ignore iProduct and
839 only use idProduct, and updated man page
840 - updated breset to recognize the Pearl in 00004 mode as well
841 - changed src/probe.cc logic to assume that the second endpoint
842 pair is the one needed for database communication, instead
843 of doing a reverse search from the end... newer Pearls
844 in Dual mode seem to have at least 3 or 4 endpoint pairs,
845 and the old search didn't always work
846 - applied sourceforge patch #1696884 from Peter Silva, updating
847 the Debian build for Etch, and including all files in one deb
848 - added Peter Silva to AUTHORS file
849 - uncommented the "make distclean" in debian/rules, and removed
850 the reliance on /tmp when installing 99-barry-perms.rules
851 - applied bb_task_format.txt patch from Peter Silva
852 - fixed each misspelling of "recurrance" to "recurrence"
853 - tweaked src/probe.cc again for paranoia's sake... start at
854 offset 1 if more than 1 endpoint pair, otherwise start
856 - split up opensync module into multiple source files, and started
857 using the opensync vformat routines for parsing and building
858 the vevent20 data (experimental)
860 - more incremental work on the opensync plugin, adding ADDED
861 and MODIFIED functionality... (experimental!)
863 - added code to dump extra descriptors during device discovery,
865 - bumped opensync version number in configure.ac, and made
866 the configure scripts more consistent with the rest
868 - fixed printf-format size bug in opensync module
870 - applied patch from Niels de Vos, fixing deb udev rules for Pearl
872 - fixed extra space bug in LDIF output (added space when creating
873 FullName, even if there was no last name)
874 - fixed Address Book record parsing in Contact class... the
875 Blackberry database uses field id 0x20 for both the
876 first and last names, and if only a last name exists,
877 the first name will be empty. Fixed parser to handle
878 this special case, without relying on string length.
879 Thanks to Troy Engel for reporting above two LDIF bugs.
880 - added a few more constants to bcharge.cc
881 - renamed opensync's configure.in to configure.ac
883 - fixed bcharge to avoid endless reset loop... oops
885 - reorganized bcharge.cc to make it possible to switch between
886 Pearl modes 0004 and 0001
887 - added flag to BadPassword exception class, to signal whether
888 the library considers the device "out of retries" or not
889 - updated socket.cc for new BadPassword exception
890 - added special case to Controller class destructor to reset the
891 device if being destroyed in a half-open state... this is
892 a temporary fix until we understand how to handle
893 the "already open" message we get when opening the Desktop
895 - added password prompt dialog to the backup GUI
896 - fixed possible memory leak in GUI's DeviceInterface::Connect()
898 - committed Troy Engel's bbrules_mass_symlinks.patch, fixing
899 udev rules for the Pearl
900 - updated 10-blackberry.rules.Debian to match 10-blackberry.rules's
902 - applied Troy Engel's barry.spec patch to generate all required
903 RPM's... Thank you! Notes in the README taken from
904 the sourceforge tracker entry containing the patch.
905 - added libusb lib flags to tools/ and examples/ makefiles,
906 and tweaked configure.ac with a better default,
907 to build cleanly on RHEL 4
908 - modified rpm/barry.spec:
909 - does not create doc-only barry base package anymore
910 - fixed "barry-backup" typo
911 - removed the patch step, as version 0.7 shouldn't need it
912 - added license file to each package
913 - commented out console perms scripts, pending mailing list
916 - applied Troy Engel's barry.spec patch to fix RHEL4 compile issues
917 - fixed 80 column wrapping error in barry.spec, thanks to Troy Engel
919 - applied Troy Engel's udev permissions patch for Redhat/Fedora
920 systems, which automatically set the ownership of a
921 newly plugged in device to the currently logged in console
923 - added udev/README to document what all those files are for...
924 part of the text comes from the sourceforge comment
925 on the above udev permissions patch from Troy Engel
926 - uncommented the console perms scripts for rpm/barry.spec
927 - added libglademm-2.4 to gui/README's dependency list
928 - made usbwrap.* calls more threadsafe
929 - added Usb::Timeout exception for timeout errors
930 - added preliminary UsbSerData support to library for GPRS modem
931 functionality, using Rick Scott's XmBlackBerry's serdata.c
933 - added overloaded Socket::Send() for sending without receiving
934 - added preliminary pppob command line tool
940 - gui/src/BackupWindow.cc (about dialog)
943 - build system tweaks for opensync-plugin, and added a buildgen.sh
945 - added better debug messages in probe.cc and usbwrap.cc's
946 device discovery code
947 - changed error handling for null interface->altsetting pointers
948 when doing device discovery in usbwrap.cc. Seems that
949 some devices report a higher number in bNumInterfaces
950 than are really available... in this case, let's
951 just ignore the missing data and assume success
952 - applied udev script patch #1663986 from Troy Engel
953 - applied barry-bcharge.spec patch #1672178 from Troy Engel
954 - ReleaseChecklist update
955 - added rpm/README based on Troy Engel's patch notes
956 - updated new barry-bcharge.spec for version 0.7, removing patch
959 Release: version 0.6 - 2007/02/28
960 ------------------------------------------------------------------------------
962 - fixed size checks for device database records larger than 64K
963 Thanks to Michael Brown for the bug report.
964 - added initial release maintainer scripts
965 - fixed odd backup success message in GUI when doing a backup with
966 no databases selected in configuration
967 Thanks to Michael Brown for the bug report.
968 - added udev permissions file patch from Michael Brown
969 - added Michael Brown to AUTHORS
970 - updated README, gui/README, and doc/USB-capture.txt
971 - added -o command line switch to bcharge.cc, and updated man page
973 - changed library behaviour so it only turns on libusb debug output
974 if in data dump mode. In btool, -v controls this output.
975 - minor stream formatting fix in btool
976 - added OpenSSL dependency to build for password hash support
977 - made debug dout() output conditional on Init() flag... In btool,
978 -v now controls this as well
979 - reverse engineered more of the initial probe packets, and
980 implemented probing in struct based code... changes include:
981 - added support for "attribute fetch" packets, used at
982 the beginning of USB conversations
983 - defined object/attribute id codes for the PIN number
984 - made Protocol::SocketCommand more robust, and implemented
985 its sequence number behaviour
986 - moved ModeSelectCommand into SocketCommand, as it is a
987 socket 0 level command
988 - added initial protocol struct: PasswordChallenge
989 - renamed Barry::Packet to DBPacket
990 - added ZeroPacket for socket 0 packet creation and analysis
991 - Barry::Packet is now the base class for the above
992 - implemented socket 0 behaviour in socket.cc
993 - changed return values for Send/Receive/Packet/NextRecord
994 members in the Socket class from bool to void, as they
995 don't generate errors themselves, but only can
996 have an error if Usb::Device throws an exception.
997 Cleaned up all code that called these members as well.
998 - removed "last status" from Socket class as it was unused
999 - updated probe.cc to use new socket 0 implementation
1000 - removed two of the hard coded packet handshakes in favour
1002 - updated controller.cc:
1003 - uses new socket 0 implementation
1004 - removed "flag" hack when opening sockets and
1005 selecting modes, as it should use the
1006 socket 0 sequence number
1007 - added initial, incomplete prototype header for the C API
1008 - updated some .cvsignore files
1010 - updated ReleaseChecklist.txt, adding rpm spec file
1011 - added the following to ZeroPacket:
1016 - moved Command() to base Packet class
1017 - added comments to protostructs.h and size constants for the
1018 new PasswordChallenge struct
1019 - added password support to Socket and Controller classes
1020 Thanks to Rick Scott's XmBlackBerry for the openssl
1021 password hashing logic.
1022 - updated btool to use new password support, and updated its man page
1024 - updated Doxygen input files and version, and added to ReleaseChecklist
1025 - fixed btool PIN output for LDIF mode, now commented in output
1026 - major LDIF overhaul:
1027 - split LDIF specific code out of the record class and
1029 - fixed "full name" behaviour that added an extra space
1030 in dn attributes, as reported by Troy Engel
1031 - added support for mapping of LDIF attributes to Barry
1033 - fixed base64 handling, so attributes are only so encoded
1035 - fixed base64 attribute reading inconsistency... some
1036 notes fields were missed in old version if not
1038 - added support for specifying alternate attribute for
1039 constructing a FQDN, instead of just "cn"
1040 - updated btool and upldif to use new features
1041 - large update to btool manpage
1042 - fixed initialization bug in Contact constructor (missed RecType)
1044 - added ktrans.cc to make reading of kernel usbfs_snoop logs easier
1045 - removed commented code from translate.cc
1046 - added Pearl handshake support to bcharge.cc, which resets the
1047 Pearl so that the vendor specific 0xFF class exists.
1048 This should allow use of btool on the Pearl.
1049 - added Data::AppendHexString to data.cc
1050 - added better probing support for the Pearl, so it detects the
1051 Product ID 0x0004 mode, and does a search for class 0xFF
1052 instead of hardcoding it.
1054 - applied README patch from Ian Darwin
1055 - minor tweaks to README
1056 - added missing errno.h header in src/usbwrap.cc for AMD64
1057 Thanks to Jonathan Hudson for reporting the bug.
1058 - tightened up size checks in Data::ReleaseBuffer()
1059 - stable libusb *does* return the actual length of the USB packet...
1060 fixed this in usbwrap.cc to set the actual size of read data,
1061 and removed the size hacks elsewhere in the code:
1062 probe.cc, protocol.cc, socket.cc, usbwrap.cc
1064 - added proper return codes for error conditions in btool.cc
1065 - clarified some stream output code in the library, for hex/dec numbers
1066 - removed old, non-working connect.cc test program
1067 - added iomanip to debug.h
1068 - changed usbwrap to call libusb again if EINTR and EAGAIN
1069 This should fix one of the OpenBSD issues
1072 - fixed bug in barrybackup GUI that didn't create the target path
1073 if the user didn't do Edit | Config first.
1074 Thanks to Ian Darwin for reporting the bug.
1075 - applied gui/src/ConfigFile.cc header fix patch for OpenBSD
1078 - added initial btool.1 man page from Ian Darwin
1079 - updated man/Makefile.am for new btool.1
1081 - applied btool -h help clarification patch from Ian Darwin
1083 - reworked exception hierarchy, so applications can handle all
1084 Barry related exceptions, including Usb errors, with
1085 one base class: Barry::Error
1086 - fixed all the ripple changes this caused throughout the codebase
1087 - added BadPassword exception
1093 - gui/src/BackupWindow.cc (about dialog)
1094 - updated doc/ReleaseChecklist.txt
1095 - added usb-level breset.cc command line tool
1096 - fixed bug in gui/src/tarfile.* for systems where
1097 sizeof(int) != sizeof(void*)
1098 - TarFile class now uses a plugin style for the compression
1099 operations, to allow for threadsafe versions if needed
1101 - also fixed leaked file handle bug in open_compressed()
1102 - Thanks to Jonathan Hudson for reporting this for 64bit systems
1103 - minor signed comparison fixes in the library
1104 - added better protocol data dumping code in probe.cc
1105 - added Usb::Device::BulkDrain(), to prevent Barry from hanging
1106 due to pending reads
1108 Release: version 0.5 - 2007/01/26
1109 ------------------------------------------------------------------------------
1111 - added missing errno.h header to gui/src/util.cc
1112 - lots more endian fixes after testing on iMac
1113 - iostream output size fixes
1114 - added option to btool to reset the device via software
1115 - beefed up exception handling in barrybackup
1116 - checked in opensync work-in-progress: trace logging, pointer bugfix
1117 this is still experimental
1118 - added aboutdialog.* files from gtkmm24 2.10.6, so we have a dialog
1119 class for systems running older versions of gtkmm, like
1121 - uncommented the about box menu handler
1122 - added "cleanall" option to root buildgen.sh script
1123 - update ReleaseChecklist.txt
1124 - removed CVS auto-history strings from aboutdialog.*
1126 - found a link between the unknown field in tagged protocol headers
1127 and the unknown field in RecordStateTable entries. This
1128 field matters when uploading certain databases, such as
1129 Browser Options. It is unknown what this field really
1130 means, but we're calling it RecType. Updated the API
1131 to use this in all parser objects and builder objects
1132 and record objects that use it.
1133 - changed some uses of uint64_t to uint32_t, in Contact and
1134 Calendar record objects... unique IDs only seem to be
1136 - added new static function to record classes: GetDefaultRecType()
1137 This returns the default rectype that should work
1138 for that record. Ideally this should be retrieved from
1139 the device, but in the case where a database has no
1140 records, this info would be good to know.
1141 - updated convenience template function Controller::AddRecordByType()
1142 to use GetDefaultRecType()
1143 - documented the recurrence data and how to use it in Calendar objects
1144 - added data debug output for incoming USB packets in the
1145 socket class... when we ported to the stable libusb
1146 we lost some of the verbose output... this should get it
1147 back. (In the official release, you need to uncomment
1148 ddout() in debug.h for the full blast of debug output).
1149 - backup GUI updates:
1150 - changed error_done signal into a pure error signal,
1151 and changed the logic so the restore continues
1152 even if there was a protocol error on one database
1153 - changed status bar messages to show what's happening
1154 i.e. Backup or Restore
1155 - default to not restore the "Handheld Agent" database as
1156 it appears to be read-only on the device
1157 - added temporary Restore & Backup mode for debugging
1158 - added extra hyphen to backup files to show date/time better
1159 - updated GUI to save and restore the new RecType field
1160 supported now by the library
1162 - added future considerations to doc/ReleaseChecklist.txt
1163 - applied big endian patch from Jonathan Hudson
1165 - removed endian.h include from barry.h, since applications
1166 using the library should not care about endianness
1167 - hard coded the path to config.h in endian.h
1168 so that endian.h never makes it into the final
1170 - removed DEFAULT_INCLUDES setting from src/Makefile.am
1172 - removed config.h dependency in btool.cc and used library
1173 Version call instead
1174 - added big/little endian text to the Barry::Version call
1176 - fixed install location of bcharge when building with ./configure;
1177 now goes to sbin/ for both source compile and binary packages
1178 Thanks to Jonathan Hudson for reporting this bug.
1180 - added smarter timeout values to controller, and allowed
1181 timeout overrides in the packet, socket, and usbwrap code...
1182 extra timeouts are needed for erasing databases for
1184 - added an explicit DataDumpParser class to btool.cc, as the
1185 library doesn't always have extreme verbose debugging on...
1186 this makes sure anyone can always get raw database packets
1187 through btool, for development
1188 - added thread callback signals for error finishes and erase_db
1189 operations, so the GUI is updated properly
1190 - more GUI cleanups (status bar updates, etc)
1191 - finished implementation of GUI restore
1192 - fixed gtkmm/glibmm exception handling when the exceptions
1193 occur in sigc signal handlers... in that case,
1194 exceptions need to be handled with
1195 Glib::add_exception_handler()
1196 - added filename-only reading support to TarFile class
1197 - added pending gui/TODO items
1199 - backup GUI now properly shows progress
1200 - the buttons become insensitive when backup is busy
1201 - refactored directory check code, and added mkdir check
1202 when to the backup setup (so the directory exists
1203 when we try to write to it)
1204 - updated code to use Barry::Data in new namespace
1206 - moved Data class into Barry namespace
1208 - updated copyright dates for the new year
1209 - clarified exception message in controller.cc
1210 - fixed pointer initialization bug in controller.cc
1211 - added documentation comments to parser.h and builder.h
1212 - updated ReleaseChecklist.txt
1214 - changed Barry library configure scripts to make better
1215 use of pkg-config for autodetecting dependencies
1216 - added initial Barry Backup GUI (gui/ directory), capable of making
1217 backups only at this point
1219 - added doc/ReleaseChecklist.txt
1220 - added version API, returning version number and string
1221 - added Troy Engel to AUTHORS
1222 - added special case to bcharge.cc for the Blackberry Pearl,
1223 which doesn't reset itself after the charge handshake
1224 Thanks to Troy Engel for testing.
1226 - added pkg-config support for the library (libbarry-0.pc.in)
1227 - fixed compile error on g++ 3.3 systems (missing stdint.h
1229 - fixed protocol hang at end of Controller operation... in
1230 controller destructor, it was deleting the USB interface
1231 before closing the socket at the BlackBerry level, thereby
1232 leaving the device in Desktop mode
1234 - support the newer udev packages on Ubuntu, which need slightly
1236 - modified bcharge.cc to search for Pearl devices too.
1238 - added Pearl product ID to probe code, but likely not functional
1239 yet until we find someone able to get a USB capture for us
1241 - version bump in configure.ac and src/Makefile.am
1243 Release: version 0.4 - 2006/12/29
1244 ------------------------------------------------------------------------------
1246 - added bcharge.cc to the tools/ directory (whoohoo!)
1247 - added initial release version of rpm/barry.spec (aka bcharge.spec)
1248 This begins the barry binary release, currently only
1249 including the bcharge utility, but possibly more in
1250 the future. Future binary packages will likely include
1251 libbarry, libbarry-devel, etc, which barry will then
1253 - added udev rule script for BlackBerry devices
1254 - added man/ directory and bcharge.1 manpage
1255 - added debian/ directory for building deb packages, with initial
1257 - added rpm/make-rpm-tarball.sh for building RPMs
1258 - split out technical docs into separate libbarry.docs file for
1259 a future Debian install
1260 - added more cleaning to buildgen.sh
1261 - added new udev rule file for Debian stable
1262 - hardcoded g++ to 3.3 in debian/rules as I have multiple versions
1263 on my system and need to compile releases with stable
1265 - ported Barry to use the stable branch of libusb
1266 NOTE: no longer depends on the devel libusb tarball!
1267 Just use your distro's libusb packages.
1268 - fixed more endian issues
1269 - minor update to TODO
1271 - moved Exceptions, Hacking, and VersionNotes to doc/
1272 - added doc/USB-capture.txt
1274 - added Controller::AddRecord() and template helper
1275 - added beginning version of generic RecordFetch<> template
1276 - set default of Barry::Init() to false (no data dump mode)
1277 - added examples/ directory, with first addcontact.cc example
1279 - added autoconf support based on Peter McAlpine's patch
1280 - renamed Makefiles to Makefile.orig and added script to turn
1281 on old build system if wanted
1282 - fixed boost-specific error path in btool
1283 - moved platform specific code out of time.h and into time.cc
1284 - moved btool.cc, translate.cc, and upldif.cc out of src/ and
1285 into their own tools/ subdirectory
1286 - added NEWS file to make autotools happy
1287 - added a "clean" option to the buildgen.sh script... maintainer's
1289 - reworked autoconf and automake files, to support
1290 barry as a library, to move the programs into their
1291 own tools directory, and support a proper installation
1292 - fixed headers in parser.h, btool.cc, and upldif.cc to work
1293 properly when installed standalone
1294 - added tools/Makefile.plain for testing compiling against
1295 installed barry library
1296 - added commentary on version number system
1297 - removed Makefile.conf and Makefile.orig, as new autoconf
1298 system supercedes it
1299 - added support for boost serialization library in autoconf build
1300 - added library version number to autoconf build
1301 - changed boost flag to __BARRY_BOOST_MODE__ to avoid collisions
1302 - removed debug.h dependency from btool.cc
1303 - removed libusb check in favour of specific --with-libusb
1304 option... may need to revisit this later
1305 - quick installation update in README
1307 - fixed some missed endian conversions in record.cc and added
1309 - fixed endian issues in time.h
1310 - added 2 more functions to the time zone API, and adjusted
1311 the time zone table for better defaults in North America
1312 - added btool and upldif to the make install sequence
1313 - added support for Calendar recurrence data
1314 - small doc/TimeZones.txt update
1316 - added BlackBerry time zone code list, reverse engineered from a 7750
1317 - added GetTimeZone() to convert device time zone codes to useful data
1319 Release: version 0.0.3 - 2006/11/24
1320 ------------------------------------------------------------------------------
1322 - added return code check to Controller::SaveDatabase()
1323 - fixed Data() class constructor, so it doesn't auto-convert
1325 - fixed size checking bug in Packet::ReturnCode() that caused
1326 uploading to device to fail
1328 - added Exceptions doc file, documenting the C++ exceptions used,
1330 - fixed small bug in 'make install' which didn't build first
1331 - minor documentation and cleanup in upldif.cc
1332 - added utility functions to the RecordStateTable class,
1333 GetIndex() and MakeNewRecordId()
1334 - changed btool so that the -d command modifiers can be
1335 specified multiple times to work with multiple records
1337 - added Calendar sync code to the opensync module (not complete)
1338 - cleaned up exception handling in the opensync module, making
1339 more use of the base exception to make sure no
1340 exceptions leak into the C library code
1342 Release: version 0.0.2 - 2006/10/12
1343 ------------------------------------------------------------------------------
1345 - fixed casting error in opensync module
1346 - minor updates to documentation to prepare for release
1348 - added stdint.h to parser.h for uint32_t. Thanks Ron Gage for
1351 - large refactoring of the packet parsing and building code,
1352 splitting the code into 3 groups:
1353 - record: handles record specific parsing and building...
1354 this is mostly subfields with CommonField structs
1355 as their headers, but sometimes has a specific
1356 header of its own, in the case of email
1357 Note: email's header is as yet undecoded.
1358 Record does not know the details of the packet
1359 formats, only the formats of its own record data.
1360 - packet: handles building of complete command packets
1361 and handles parsing of commonly used header values,
1362 providing an API for it... packet does not know
1363 the record format details, but does know the
1364 details of each Database Operation (protocol.h)
1366 So far, it seems that there is a real separation
1367 of operation formats and record formats, with the
1368 record formats being the same even with different
1369 database operation codes (GET_RECORDS /
1370 OLD_GET_RECORDS), which was not confirmed before.
1371 See the header size of the email record after
1373 - controller: handles device state, and the management of
1374 sockets, commands, and checking for response values.
1375 The Controller object does not know the format
1376 of either the record or the packet it is sending,
1377 but does know the protocol handshake logic used
1378 to talk to the device.
1379 - implemented SetRecord (SET_RECORD_BY_INDEX)... syncing, here
1381 - spelling correction in opensync-plugin/AUTHORS
1383 - added sample hotplug scripts
1384 - added .cvsignore files for doxygen and opensync directories
1385 - added src/endian.h... still need to add configure support to
1386 handle non-little-endian machines
1387 - added exception handler in opensync plugin commit_change()
1388 - removed the device reset code in probe.cc, as resetting a device
1389 can renumber the devices in /proc on kernel 2.4.x,
1390 and cause a failure to reach the device...
1391 FIXME - this should be changed someday to reset if probing
1392 fails, and restart the probe on reset, as sometimes
1393 the blackberry devices respond differently when not reset
1394 Ideally, the probe protocol should be properly reverse
1396 - added support for retrieving record state table, which is needed
1398 - added support for retrieving, deleting, and clearing the dirty
1399 flags of individual blackberry device records
1400 - added endian macros throughout the code
1402 - added opensync-plugin to root Makefile's clean
1403 - updated time conversion calls to match opensync's latest SVN
1404 - added opensync_change_set_changetype() (only add for now,
1406 - removed slow sync functions for now
1408 - added quick "install" makefile target, to src/install by default
1409 - added static library target... this is temporary until autoconf
1410 stuff is added properly... needed for the opensync plugin
1411 - documented in comments that Barry::BError is intended to be
1412 the base classes for all exceptions
1413 - added first round of implementation of an opensync plugin, based
1414 on the example plugin code from the opensync sources
1416 - added to Contact record class:
1418 - ReadLdif() to load and parse LDAP data
1419 - added fragmented send support to Socket class
1420 - added Probe::FindActive() to make client programs more streamlined
1421 - fixed hex/decimal printing of record counts in btool
1422 - added upldif.cc, a utility to take ldapsearch output on stdin
1423 and upload it to a blackberry
1424 - updated src/.cvsignore
1426 - added parsing of service book fields:
1428 - old and new unique ID (UID)
1430 - old and new description
1432 - bes domain / domain
1433 - date change in legal.txt
1434 - added initial parsing of ServiceBook field 0x09, and calling it
1435 ServiceBookConfig for now, for lack of a better name
1436 - added parsing for ServiceBook field 0x02 on 72xx Blackberries...
1437 seems to be a name or description, but doesn't appear
1438 in the device's own GUI... called "Hidden Name" for now
1440 - added ServiceBook record class and parser code, based on some
1441 of Ron Gage's reverse engineering... code is by Chris Frey
1442 - added AUTHORS file
1443 - fixed the libusb set_configuration/claim_interface order
1444 bug in controller.{h,cc}... already fixed in probe,
1445 but not controller. Thanks Ron Gage for finding this.
1447 - renamed Changelog to ChangeLog in preparation for autoconf
1448 - renamed Todo to TODO in preparation for autoconf
1450 - make clean cleans up tests properly now
1452 - turned source code browsing on in Doxyfile
1453 - added LoadDatabaseByName() and LoadDatabaseByType() template members
1454 to the Controller class
1455 - new file: controllertmpl.h
1456 - documentation fixes in builder.h
1457 - added static GetDBName() functions to all record classes, in
1458 support of the template Controller functions
1459 - fleshed out DatabaseDatabase::GetDBNumber() and GetDBName(),
1460 returning errors properly
1461 - documented sample btool.cc code better, and added example
1462 of Controller template member usage
1464 - copyright dates updated for 2006
1466 - backed out update to latest libusb DEVEL tree, since it is buggy.
1467 Stick with libusb 2005/11/26
1469 - added clean target to convenience Makefile
1470 - added Boost to list of dependencies in README
1471 - fixed minor compile warnings in base64.cc
1472 - fixed new USB discovery code, and changed endpoint usage to use
1473 it, instead of the READ_ENDPOINT and WRITE_ENDPOINT
1474 constants... constants are now removed
1475 common.h, controller.cc, probe.cc, probe.h, usbwrap.cc
1476 - added ClearHalt() to Usb::Device (usbwrap.cc)
1477 - updated usbwrap.h to match latest libusb CVS devel tree
1478 - updated README to refer to 2005/12/30 libusb CVS devel tree
1479 - added roadmap to Todo list
1481 - added convenience Makefile in root directory
1482 - added Hacking document
1483 - minor touchups to README
1484 - added caution warning to README, since this release will support
1485 delete / overwrite / upload functionality
1486 - minor compile order change in Makefile (speed reasons)
1487 - added dynamic endpoint discovery to probe.cc
1488 - changed claim_interface/set_configuration() function call order in
1489 probe.cc based on feedback on the libusb mailing list
1490 - added USB discovery code to usbwrap.{h,cc}
1492 - fixed packing bug in new upload header struct
1493 - renamed CommonField union from data to u to be consistent
1494 - added return_code field to DBAccess struct, for error checking
1495 - added response checking during upload: if response is non-zero
1496 throw exception in controller.cc
1497 - added sorting operators to record parser classes... when writing
1498 contact data to the device, it may be important to write
1499 group link items last, since they reference other contacts...
1500 This needs to be tested, and if not required, removed.
1501 - added GROUP_FLAG field code to Contact parser class
1502 - fixed offset bug in Contact and Calendar Build() functions
1503 - fixed name bug in Contact::Build(), now output only with data
1504 - added appointment type flag support to Calendar record parser
1505 class, and "all day event" flag support
1507 - added autoconf to Todo list
1508 - refactored the protocol structures so that record structs can
1509 be reused for upload and download
1510 - with new protostructs, more header control is handled by
1511 controller.cc instead of record.cc parsers and builders
1512 - parser code now accepts an offset, to govern start of record data
1513 - changed Data sizes from int to size_t and removed casts
1514 - removed unneeded Parser::GetHeaderSize() (new protostructs make
1516 - added Calendar::Build() for calendar uploads
1518 - added s11n-boost.h serialization templates for boost::serialization
1519 - added boost::serialization to build
1520 - minor change in usbwrap.cc to display error codes in decimal
1521 - added SizePacket special case code to Socket::Send()... this is
1522 required when uploaded packet size is a multiple of 0x40,
1523 a special 3 byte size packet is sent
1524 - moved some record class variables to public: so they can be
1526 - fixed variable name but in RecordBuilder template
1527 - added -f switch to btool, for saving and loading of record data
1528 - added -s switch to btool, for uploading saved data back to handheld
1529 - added Controller::SaveDatabase()
1531 - fixed potential casting / pointer bug in controller.cc
1532 - added builder.h, to support uploading
1533 - minor comment fixes in parser.h
1534 - added preliminary Contact protocol record building support
1535 - fixed field order bug in ContactRecord protocol struct
1536 - Contact record.h class now saves unknown Group Link field,
1539 - added -fno-strict-aliasing to compiler flags so gcc-4.0.x won't
1540 optimize away protocol struct casts
1542 http://gcc.gnu.org/bugzilla/show_bug.cgi?id=25235
1543 http://mail-index.netbsd.org/tech-kern/2003/08/11/0001.html
1544 http://groups.google.ca/group/comp.lang.c++.moderated/ \
1545 browse_thread/thread/e7bf096832526f8e/5714701b \
1546 02a2a3cc?hl=en#5714701b02a2a3cc
1547 - changed headers so that any low level protocol-specific sizes and
1548 structs are completely hidden in the library...
1549 this adds library-only header: protostructs.h
1551 Release: version 0.0.1 - 2005/11/25
1552 ------------------------------------------------------------------------------
1554 - added barry.h for documentation purposes and application usage
1555 - updated README for release
1556 - renamed SBError exception class to BError
1557 - updated Doxyfile to version 1.4.5
1558 - added more doxygen comments
1560 - added conversion routines (and tests) between time_t and min1900_t
1561 - added -v option to btool to dynamically control protocol dumping
1562 - removed duplicated database database table display in controller.cc
1563 - minor spelling corrections
1564 - added copyright to usbwrap.{h,cc} as per earlier meeting
1565 - added support for Old protocol Calendar entries
1567 - added legal.txt, to save typing when adding new source files
1568 - ignore test-base64 file (cvsignore)
1569 - added contact-to-ldif generation, and updated supporting code
1570 - added argument to btool to support contact-to-ldif operation
1571 - added Contact::GetPostalAddress()
1572 - added README documentation in preparation for future release
1574 - added parser.{h,cc} virtual wrapper to generalize LoadDatabase()
1575 - added code to socket.cc's Packet() command to re-receive on
1576 reception of empty packets... this seems to be a signal
1577 from the device that it needs more time for long transfers
1578 Current limit: 10 blank packets before exception is thrown
1579 Observed maximum blank count: 1
1580 - added MessageRecord and OldMessageRecord to protocol.h
1581 - changed common record field structs to one CommonField struct
1582 - increased default USB timeout to 10 seconds (some loaded devices
1583 seem to need more time...)
1584 - reorganized record.{h,cc} to try to reduce the code duplication
1585 - record.h classes now "know" the sizes of their corresponding
1586 protocol structs... this may cause trouble down the line
1587 with Python, if used(?)
1588 - added Message class for Email records
1589 - removed the "Get*" database functions and replaced with
1590 general LoadDatabase() call, which loads any database
1591 available, and parses it with a Parser object
1592 - added GetDBID() for searching for database numbers via name
1593 - added test code to retrieve and display all email
1594 - cleaned up comments
1595 - renamed blackberry.{h,cc} to controller.{h,cc}
1596 - renamed bbtool.cc to btool.cc
1597 - added Makefile.conf
1598 - added copyright notices to source files
1599 - added COPYING file with GPL
1600 - put parser in Barry namespace, and added auto_ptr-like mode for
1601 store object pointers
1602 - added doxygen docs
1603 - added header comments to convo.awk script
1604 - removed Test() function in Controller object, and made class
1605 better suited to its general API purpose
1606 - changed OpenMode() so it loads command table and DBDB... it is now
1607 a public API function
1608 - moved Controller test code to btool.cc and made tool more
1609 generically useful... can now download any DB by name on
1611 - added mode checks to Controller
1612 - added -t and -d command line options to btool
1613 - added base64 routines from John Walker / Fourmilab and Citadel/UX
1614 - converted base64 routines into an API, instead of hardcoded
1617 - changed project name to Barry, including namespaces
1618 - renamed sbcommon.* to common.*
1619 - increased USB default timeout to 2 seconds
1620 - fixed formatting bug in Data operator<< output
1621 - cleaned up the protocol packet structs, getting rid of the
1622 confusing param/simple split... param is now the tableCmd
1623 from the Command Table
1624 - moved protocol structs from record.h to protocol.h
1625 - added support for older version of the USB protocol, which matches
1626 the Cassis spec more closely
1627 - fixed the hardcoded offsets in blackberry.cc's protocol parsing
1628 - fixed Socket::Close() so on error, socket flags are reset.
1629 This stops Close() from being called twice on exception
1632 - added Doxyfile to the project
1634 - added mode selection support to Blackberry class (RIM Desktop,
1635 RIM Bypass, and RIM_JavaLoader)
1636 Mode selection governs which socket is used in subsequent
1638 - added Command Table parsing and protocol support
1639 Blackberry class, and CommandTable record class
1640 - added Database database parsing and protocol support
1641 Blackberry class and DatabaseDatabase record class
1642 - added Address book retrieval support - dumps data to stdout for now
1643 - fixed bug in CopyOnWrite mode in Data class, where could allocate
1644 less buffer than data copied
1645 - added "easy exception" debug output macro
1646 - fixed minor spelling error in protocol.cc
1647 - fixed ModeSelectCommand protocol structure - it is not a parameter
1648 command, but uses the unknown slots for socket and flag
1650 - removed hardcoded socket numbers from protocol.h
1651 - fixed bug in socket.cc:Open() where packet size was not properly
1653 - implemented socket::Close()
1654 - fixed sequence number checks, so it is reset properly on socket 0
1655 - added Socket::NextRecord() for multiple record data transfers
1656 - fixed input handling bug in translate.cc
1658 - added .cvsignore files to project
1659 - added README notes to document the source architecture
1660 - added dbsetup data script, which shows how to get into database
1661 mode, using the RIM Desktop mode, and open a socket
1662 - added blackberry.{h,cc} class
1663 - added command line parameters to bbtool.cc
1665 -p = specify pin of blackberry device
1666 - added blackberry test code in bbtool.cc - debugging the initial
1667 opening protocol: sockets, modes, etc... see dbsetup for
1669 - added copy-on-write functionality to Data class, so it can be used
1670 with plain data buffers with little performance impact
1671 - added eout() and ddout() debugging - to separate:
1672 - regular debug output
1673 - exception debug output (should probably be logged to
1674 syslog someday, and never turned off)
1675 - raw data dump output
1676 - changed errno SBError exception handler to try to decode the error
1677 numbers into english (limited success)
1678 - fixed probe and socket USB Bulk message handling, so they don't
1679 use PollCompletions(), but use IO::Wait() (libusb_io_wait())
1680 - added common packet size checker in protocol.cc
1681 - fixed unpacked protocol packet structs... using gcc's
1682 __attribute__ ((packed)) ... see protocol.h
1683 - added ModeSelectCommand structure (protocol.h)
1684 - finished Socket::Open() call (Close() not yet implemented)
1685 - moved Socket::Send/Receive() out of private, as they can be used
1686 for socket 0 operations.
1687 - cleaned up pointer management with macros:
1691 - added IO::Wait() and IO::Cancel() to correspond with libusb API
1692 - added datadumping in usbwrap for easy protocol capture
1693 - added preliminary record.{h,cc} classes
1694 - added Contact record parsing, and test code
1696 - syncberry tree started