<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>pre-unlock</title><link rel="stylesheet" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Version Control with Subversion" /><link rel="up" href="svn.ref.reposhooks.html" title="Repository Hooks" /><link rel="prev" href="svn.ref.reposhooks.post-lock.html" title="post-lock" /><link rel="next" href="svn.ref.reposhooks.post-unlock.html" title="post-unlock" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">pre-unlock</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="svn.ref.reposhooks.post-lock.html">Prev</a> </td><th width="60%" align="center">Repository Hooks</th><td width="20%" align="right"> <a accesskey="n" href="svn.ref.reposhooks.post-unlock.html">Next</a></td></tr></table><hr /></div><div class="refentry" lang="en" xml:lang="en"><a id="svn.ref.reposhooks.pre-unlock"></a><div class="titlepage"></div><a id="id429020" class="indexterm"></a><div class="refnamediv"><h2>Name</h2><p>pre-unlock — Notification of a path unlock attempt.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id429046"></a><h2>Description</h2><p>The pre-unlock hook runs whenever someone attempts to remove a lock on a file. It can be used to create policies that specify which users are allowed to unlock particular paths. It's particularly important for determining policies about lock breakage. If user A locks a file, is user B allowed to break the lock? What if the lock is more than a week old? These sorts of things can be decided and enforced by the hook.</p><p>If the pre-unlock hook program returns a non-zero exit value, the unlock action is aborted and anything printed to stderr is marshalled back to the client.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id429065"></a><h2>Input Parameter(s)</h2><p>The command-line arguments passed to the hook program, in order, are:</p><div class="orderedlist"><ol type="1"><li><p>repository path</p></li><li><p>versioned path which is to be locked</p></li><li><p>authenticated username of the person attempting the lock</p></li></ol></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id429103"></a><h2>Common Uses</h2><p>access control</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="svn.ref.reposhooks.post-lock.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="svn.ref.reposhooks.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="svn.ref.reposhooks.post-unlock.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">post-lock </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> post-unlock</td></tr></table></div></body></html>