summaryrefslogtreecommitdiff
path: root/libexec/lockspool
diff options
context:
space:
mode:
authorTodd C. Miller <millert@cvs.openbsd.org>2008-10-01 20:33:08 +0000
committerTodd C. Miller <millert@cvs.openbsd.org>2008-10-01 20:33:08 +0000
commit01ae3d3033d6579380a22c684398acc72d523e7e (patch)
tree551dab7906dfda670c0357427ce27de91e51360c /libexec/lockspool
parent8c85c558ca4943b0654bce019b4aec72cd391d73 (diff)
Mention how lockspool is expected to be used.
Diffstat (limited to 'libexec/lockspool')
-rw-r--r--libexec/lockspool/lockspool.113
1 files changed, 11 insertions, 2 deletions
diff --git a/libexec/lockspool/lockspool.1 b/libexec/lockspool/lockspool.1
index 2f4d6693347..7c6b18cc794 100644
--- a/libexec/lockspool/lockspool.1
+++ b/libexec/lockspool/lockspool.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: lockspool.1,v 1.9 2007/05/31 19:19:40 jmc Exp $
+.\" $OpenBSD: lockspool.1,v 1.10 2008/10/01 20:33:07 millert Exp $
.\"
.\" Copyright (c) 1998 Todd C. Miller <Todd.Miller@courtesan.com>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: October 1 2008 $
.Dt LOCKSPOOL 1
.Os
.Sh NAME
@@ -49,6 +49,15 @@ is written and an error message is written to stderr.
will try up to 10 times to get the lock (sleeping
for a short period in between tries).
.Pp
+Typical usage is for a user mail agent (such as
+.Xr mail 1 )
+to open a pipe to
+.Nm
+when it needs to lock the user's mail spool.
+Closing the pipe will cause
+.Nm
+to release the lock.
+.Pp
The
.Nm
utility exits 0 on success, and 1 if an error occurs.