Differential D24795 Diff 73092 head/lib/libutil/uucplock.3

Changeset View

Standalone View

head/lib/libutil/uucplock.3

	Show All 19 Lines
	.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,			.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY			.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT			.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF			.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
	.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.			.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\" "			.\" "
	.Dd March 30, 1997			.Dd May 10, 2020
	.Dt UUCPLOCK 3			.Dt UUCPLOCK 3
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm uu_lock ,			.Nm uu_lock ,
	.Nm uu_unlock ,			.Nm uu_unlock ,
	.Nm uu_lockerr			.Nm uu_lockerr
	.Nd acquire and release control of a serial device			.Nd acquire and release control of a serial device
	.Sh LIBRARY			.Sh LIBRARY
	▲ Show 20 Lines • Show All 128 Lines • ▼ Show 20 Lines
	Refer to the description of			Refer to the description of
	.Xr unlink 2			.Xr unlink 2
	for further details.			for further details.
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr lseek 2 ,			.Xr lseek 2 ,
	.Xr open 2 ,			.Xr open 2 ,
	.Xr read 2 ,			.Xr read 2 ,
	.Xr write 2			.Xr write 2
				.Sh HISTORY
				The functions
				.Fn uu_lock ,
				.Fn uu_unlock
				and
				.Fn uu_lockerr
				first appeared in
				.Fx 2.0.5 .
	.Sh BUGS			.Sh BUGS
	It is possible that a stale lock is not recognised as such if a new			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			processes is assigned the same processes id as the program that left
	the stale lock.			the stale lock.
	.Pp			.Pp
	The calling process must have write permissions to the			The calling process must have write permissions to the
	.Pa /var/spool/lock			.Pa /var/spool/lock
	directory.			directory.
	There is no mechanism in place to ensure that the			There is no mechanism in place to ensure that the
	permissions of this directory are the same as those of the			permissions of this directory are the same as those of the
	serial devices that might be locked.			serial devices that might be locked.