[Pkg-samba-maint] FHS patch documentation
vorlon at debian.org
Tue Jul 10 05:59:18 UTC 2007
I've just updated the fhs.patch in svn with some fixes for some new
references to lock_path() that were overlooked when merging. Since this has
been an ongoing problem, I've also taken the time to add some documentation
to fhs.patch itself, detailing the necessary steps to be taken for this
patch on each new upstream release.
Here is a copy of that documentation.
The patch *must* be reviewed after every new upstream release.
FAILURE TO DO SO MAY RESULT IN DATA LOSS FOR OUR USERS!
quilt push fhs.patch
grep -r lock_path source/ | grep -vE \
- This will get you the list of any new, unexpected references to
lock_path. The files mentioned above are the known good uses of
lock_path; everything else needs to be investigated.
- If the file name occurs elsewhere in the fhs.patch, update the
patch to fix these new references to the same place (either
cache_path or state_path)
- If the file is a tdb file, and the code that opens it uses
TDB_CLEAR_IF_FIRST, lock_path is correct; just update the query
above with the new filename, no other changes are needed.
- Otherwise, if this is the first use of the file, you must
determine where the file belongs -- i.e., whether it's
persistent data, a cache, or runtime-only data. Consult
upstream if necessary.
- Repeat these steps for lp_lockdir(), which is less common but
still used in the code.
grep -r lp_lockdir source/ | grep -vE \
Steve Langasek Give me a lever long enough and a Free OS
Debian Developer to set it on, and I can move the world.
vorlon at debian.org http://www.debian.org/
More information about the Pkg-samba-maint