summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authormillert <millert@openbsd.org>2005-01-01 00:07:14 +0000
committermillert <millert@openbsd.org>2005-01-01 00:07:14 +0000
commitbeab8a87ef1fc4b473117110bf24f7efa339c7d7 (patch)
tree15f85723cbd44f2badfb8e80503aad820b28ea70 /lib
parentip6.4 comes back, rewritten from scratch (diff)
downloadwireguard-openbsd-beab8a87ef1fc4b473117110bf24f7efa339c7d7.tar.xz
wireguard-openbsd-beab8a87ef1fc4b473117110bf24f7efa339c7d7.zip
Add example; OK ian@ deraadt@ jaredy@
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/sys/chroot.216
1 files changed, 15 insertions, 1 deletions
diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2
index 4eea335cc9d..eda3f3a4211 100644
--- a/lib/libc/sys/chroot.2
+++ b/lib/libc/sys/chroot.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: chroot.2,v 1.12 2004/01/24 16:17:50 jmc Exp $
+.\" $OpenBSD: chroot.2,v 1.13 2005/01/01 00:07:14 millert Exp $
.\" $NetBSD: chroot.2,v 1.7 1995/02/27 12:32:12 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
@@ -71,6 +71,20 @@ Upon successful completion, a value of 0 is returned.
Otherwise, a value of \-1 is returned and
.Va errno
is set to indicate an error.
+.Sh EXAMPLES
+The following example changes the root directory to
+.Va newroot ,
+sets the current directory to the new root, and drops any
+setuid privileges.
+.Bd -literal -offset indent
+#include <err.h>
+#include <unistd.h>
+
+if (chroot(newroot) != 0 || chdir("/") != 0)
+ err(1, "%s", newroot);
+seteuid(getuid());
+setuid(getuid());
+.Ed
.Sh ERRORS
.Fn chroot
will fail and the root directory will be unchanged if: