[Zodb-checkins] CVS: ZODB3/Tools - fsrefs.py:188.8.131.52
tim.one at comcast.net
Sat Jul 10 21:47:32 EDT 2004
Update of /cvs-repository/ZODB3/Tools
In directory cvs.zope.org:/tmp/cvs-serv7028/Tools
Repaired massive lies I introduced about wether fsrefs requires
application code to be available. Noted that fsrefs also partly
verifies the sanity of the .fs.index file.
=== ZODB3/Tools/fsrefs.py 184.108.40.206 => 220.127.116.11 ===
--- ZODB3/Tools/fsrefs.py:18.104.22.168 Fri Jul 9 22:42:11 2004
+++ ZODB3/Tools/fsrefs.py Sat Jul 10 21:47:32 2004
@@ -20,12 +20,13 @@
fsrefs.py checks object sanity by trying to load the current revision of
every object O in the database, and also verifies that every object
-directly reachable from each such O exists in the database. Note that
-application code implementing objects (or at least defining their classes)
-must be available, an d on PYTHONPATH, for fsrefs to work, because objects
-are actually loaded. On a ZEO server, all the application code typically
-isn't present, so it may be difficult to run fsrefs usefully on a ZEO
+directly reachable from each such O exists in the database.
+It's hard to explain exactly what it does because it relies on undocumented
+features in Python's cPickle module: many of the crucial steps of loading
+an object are taken, but application objects aren't actually created. This
+saves a lot of time, and allows fsrefs to be run even if the code
+implementing the object classes isn't available.
A read-only connection to the specified FileStorage is made, but it is not
recommended to run fsrefs against a live FileStorage. Because a live
@@ -36,10 +37,7 @@
fsrefs doesn't normally produce any output. If an object fails to load, the
oid of the object is given in a message saying so, and if -v was specified
then the traceback corresponding to the load failure is also displayed
-(this is the only effect of the -v flag, and is usually very helpful; -v is
-recommended for normal use). Note that, as mentioned above, a common
-problem is to get a "failed to load" message simply because the module
-containing the class of the object isn't on PYTHONPATH.
+(this is the only effect of the -v flag).
Two other kinds of errors are also detected, one strongly related to
"failed to load", when an object O loads OK, and directly refers to a
@@ -56,6 +54,10 @@
seen by fsrefs before P, an "O refers to the unloadable P" message will
not be produced; a message saying that P can't be loaded will be
produced when fsrefs later tries to load P, though.
+fsrefs also (indirectly) checks that the .index file is sane, because
+fsrefs uses the index to get its idea of what constitutes "all the objects
+in the database".
Note these limitations: because fsrefs only looks at the current revision
of objects, it does not attempt to load objects in versions, or non-current
More information about the Zodb-checkins