diff options
| author | Mike Pritchard <mpp@FreeBSD.org> | 1997-04-01 17:44:31 +0000 |
|---|---|---|
| committer | Mike Pritchard <mpp@FreeBSD.org> | 1997-04-01 17:44:31 +0000 |
| commit | b5ebf1f5cde72e225f8bf989d82e7d8a1d9ebb45 (patch) | |
| tree | e8ba967a3d4876180fbd4cf86c961619002342c7 /lib/libutil | |
| parent | d5e1fb3173450f38838dd97bb1d6b0ef99e041cf (diff) | |
Notes
Diffstat (limited to 'lib/libutil')
| -rw-r--r-- | lib/libutil/uucplock.3 | 19 |
1 files changed, 10 insertions, 9 deletions
diff --git a/lib/libutil/uucplock.3 b/lib/libutil/uucplock.3 index 0c1ae7e498fc..1841df3be5cf 100644 --- a/lib/libutil/uucplock.3 +++ b/lib/libutil/uucplock.3 @@ -23,14 +23,15 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: uucplock.3,v 1.1 1997/03/30 12:11:29 brian Exp $ +.\" $Id: uucplock.3,v 1.2 1997/03/31 22:47:53 brian Exp $ .\" " .Dd March 30, 1997 .Os .Dt uucplock 3 .Sh NAME .Nm uu_lock , -.Nm uu_unlock +.Nm uu_unlock , +.Nm uu_lockerr .Nd acquire and release control of a serial device .Sh SYNOPSIS .Fd #include <libutil.h> @@ -50,7 +51,7 @@ command line. The .Fn uu_lock function attempts to create a lock file called -.Dq /var/spool/lock/LCK.. +.Pa /var/spool/lock/LCK.. with a suffix given by the passed .Fa ttyname . If the file already exists, it is expected to contain the process @@ -120,9 +121,9 @@ is passed, an empty string is returned. Otherwise, a string specifying the reason for failure is returned. .Fn uu_lockerr uses the current value of -.Dv errno +.Va errno to determine the exact error. Care should be made not to allow -.Dv errno +.Va errno to be changed between calls to .Fn uu_lock and @@ -131,13 +132,13 @@ and If .Fn uu_lock returns one of the four error values above, the global value -.Dv errno +.Va errno can be used to determine the cause. Refer to the respective manual pages for further details. .Pp .Fn uu_unlock will set the global variable -.Dv errno +.Va errno to reflect the reason that the lock file could not be removed. Refer to the description of .Xr unlink 2 @@ -158,14 +159,14 @@ process. If this happens, returns .Dv UU_LOCK_READ_ERR and errno is set to -.Dv EINVAL . +.Er EINVAL . .Pp It is possible that a stale lock is not recognised as such if a new processes is assigned the same processes id as the program that left the stale lock. .Pp The calling process must have write permissions to the -.Dq /var/spool/lock +.Pa /var/spool/lock directory. There is no mechanism in place to ensure that the permissions of this directory are the same as those of the serial devices that might be locked. |
