From 24647b610f0a8fd89e65e964c9db63a41c64d3ae Mon Sep 17 00:00:00 2001
From: downsj <downsj@openbsd.org>
Date: Sun, 26 Jan 1997 05:10:30 +0000
Subject: [PATCH] Add lchown(), increment minor number.

---
 lib/libc/shlib_version    |  2 +-
 lib/libc/sys/Makefile.inc |  6 +++---
 lib/libc/sys/chown.2      | 26 +++++++++++++++++++++-----
 3 files changed, 25 insertions(+), 9 deletions(-)

diff --git a/lib/libc/shlib_version b/lib/libc/shlib_version
index b91c32ce7c8..b2253c1458b 100644
--- a/lib/libc/shlib_version
+++ b/lib/libc/shlib_version
@@ -1,2 +1,2 @@
 major=13
-minor=1
+minor=2
diff --git a/lib/libc/sys/Makefile.inc b/lib/libc/sys/Makefile.inc
index 172d042cc5e..2aa857aec8f 100644
--- a/lib/libc/sys/Makefile.inc
+++ b/lib/libc/sys/Makefile.inc
@@ -22,9 +22,9 @@ ASM=	accept.o access.o acct.o adjtime.o bind.o chdir.o chflags.o chmod.o \
 	getpgrp.o getpid.o getppid.o getpriority.o getrlimit.o getrusage.o \
 	getsockname.o getsockopt.o gettimeofday.o getuid.o issetugid.o \
 	ioctl.o kill.o \
-	ktrace.o lfs_bmapv.o lfs_markv.o lfs_segclean.o lfs_segwait.o link.o \
-	listen.o lstat.o madvise.o mincore.o minherit.o mkdir.o mkfifo.o \
-	mknod.o mlock.o \
+	ktrace.o lchown.o lfs_bmapv.o lfs_markv.o lfs_segclean.o lfs_segwait.o \
+	link.o listen.o lstat.o madvise.o mincore.o minherit.o mkdir.o \
+	mkfifo.o mknod.o mlock.o \
 	mount.o mprotect.o msgctl.o msgget.o msgrcv.o msgsnd.o msync.o \
 	munlock.o munmap.o nfssvc.o \
 	ntp_gettime.o ntp_adjtime.o \
diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2
index 94d8972727f..3b194b6d33c 100644
--- a/lib/libc/sys/chown.2
+++ b/lib/libc/sys/chown.2
@@ -1,3 +1,4 @@
+.\"	$OpenBSD: chown.2,v 1.3 1997/01/26 05:10:33 downsj Exp $
 .\"	$NetBSD: chown.2,v 1.10 1995/10/12 15:40:47 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993, 1994
@@ -33,22 +34,25 @@
 .\"
 .\"     @(#)chown.2	8.4 (Berkeley) 4/19/94
 .\"
-.Dd April 19, 1994
+.Dd January 25, 1997
 .Dt CHOWN 2
-.Os BSD 4
+.Os
 .Sh NAME
 .Nm chown ,
+.Nm lchown ,
 .Nm fchown
-.Nd change owner and group of a file
+.Nd change owner and group of a file or link
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <unistd.h>
 .Ft int
 .Fn chown "const char *path" "uid_t owner" "gid_t group"
 .Ft int
+.Fn lchown "const char *path" "uid_t owner" "gid_t group"
+.Ft int
 .Fn fchown "int fd" "uid_t owner" "gid_t group"
 .Sh DESCRIPTION
-The owner ID and group ID of the file
+The owner ID and group ID of the file (or link)
 named by
 .Fa path
 or referenced by
@@ -71,6 +75,12 @@ on the file
 to prevent accidental or mischievous creation of
 set-user-id and set-group-id programs.
 .Pp
+.Fn Lchown
+operates similarly to how
+.Fn chown
+operated on older systems, and does not follow symbolic links.
+It allows the owner and group of a symbolic link to be set.
+.Pp
 .Fn Fchown
 is particularly useful when used in conjunction
 with the file locking primitives (see
@@ -85,7 +95,9 @@ error code being placed in the global variable
 .Va errno .
 .Sh ERRORS
 .Fn Chown
-will fail and the file will be unchanged if:
+or
+.Fn lchown
+will fail and the file or link will be unchanged if:
 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.
@@ -150,3 +162,7 @@ and
 .Fn fchown
 functions were changed to follow symbolic links in
 .Bx 4.4 .
+.Pp
+The
+.Fn lchown
+function was added to OpenBSD due to the above.
-- 
2.20.1