[mythtv-commits] mythtv commit: r26033 by mdean

[mythtv at cvs.mythtv.org]

      Author: mdean
        Date: 2010-08-31 23:35:52 +0000 (Tue, 31 Aug 2010)
New Revision: 26033
   Changeset: http://svn.mythtv.org/trac/changeset/26033

Log:

Show mythfilldatabase's --dd-grab-all documentation in --help output.

Running mythfilldatabase --dd-grab-all results in mythfilldatabase making only a single request to DataDirect servers and pulling all available listings data at once.  This will ensure MythTV always has the most-current data available, but requires significantly more CPU and RAM during the mythfilldatabase run.  It is not expected to work on all backend systems and with all lineups, and may interfere with recording due to resource starvation.  For users whose master backend systems are sufficiently powerful, using --dd-grab-all will ensure the best listings data possible and will actually cause less strain on the DataDirect servers than the default approach of requesting tomorrow and +13 in separate runs.

Users may enable --dd-grab-all in automatic mythfilldatabase runs by specifying the argument in the "mythfilldatabase arguments" setting in mythtv-setup on the "Mythfilldatabase" screen (the last screen) of "General" settings.

The --dd-grab-all style grabbing has not yet been optimized, and future plans include changes to MythTV and the MythTV database to make its use more efficient, even on resource-limited backend systems.  That said, for users with sufficiently-powerful backend systems, I highly recommend specifying the --dd-grab-all argument in your mythfilldatabase arguments setting.  Please test first, and any corrupted recordings due to resource starvation should not be considered my fault.  (You've been warned.  :)


Modified:

   trunk/mythtv/programs/mythfilldatabase/main.cpp