# HG changeset patch
# User Siddharth Agarwal <sid0@fb.com>
# Date 1443116233 25200
# Node ID 6979a136918598254dfb1c39bb268ae186a82751
# Parent  927fa07a2ba40764072043689ba53392c6832537
lock: add a method to prepare the lock for inheritance

This is part of a series that will allow locks to be inherited by subprocesses
in limited circumstances.

diff -r 927fa07a2ba4 -r 6979a1369185 mercurial/lock.py
--- a/mercurial/lock.py	Thu Sep 24 15:57:11 2015 -0700
+++ b/mercurial/lock.py	Thu Sep 24 10:37:13 2015 -0700
@@ -158,6 +158,28 @@
         locker = self._readlock()
         return self._testlock(locker)
 
+    def prepinherit(self):
+        """prepare for the lock to be inherited by a Mercurial subprocess
+
+        Returns a string that will be recognized by the lock in the
+        subprocess. Communicating this string to the subprocess needs to be done
+        separately -- typically by an environment variable.
+        """
+        if not self.held:
+            raise error.LockInheritanceContractViolation(
+                'prepinherit can only be called while lock is held')
+        if self._inherited:
+            raise error.LockInheritanceContractViolation(
+                'prepinherit cannot be called while lock is already inherited')
+        if self.releasefn:
+            self.releasefn()
+        if self._parentheld:
+            lockname = self.parentlock
+        else:
+            lockname = '%s:%s' % (lock._host, self.pid)
+        self._inherited = True
+        return lockname
+
     def release(self):
         """release the lock and execute callback function if any