From e84ac69296d2bd901d9d5dba59a1873fc6fb7cc1 Mon Sep 17 00:00:00 2001
From: "Charles.Forsyth" <devnull@localhost>
Date: Fri, 11 Jan 2008 11:24:09 +0000
Subject: 20080111-1121

---
 man/2/INDEX |  1 +
 man/2/newns | 21 +++++++++++++++++++--
 2 files changed, 20 insertions(+), 2 deletions(-)

(limited to 'man/2')

diff --git a/man/2/INDEX b/man/2/INDEX
index 3e4da75b..8e1c43ca 100644
--- a/man/2/INDEX
+++ b/man/2/INDEX
@@ -277,6 +277,7 @@ pathname names
 relative names
 rooted names
 newns newns
+newuser newns
 categories palmfile
 dbinfo palmfile
 doc palmfile
diff --git a/man/2/newns b/man/2/newns
index 4b151558..46456617 100644
--- a/man/2/newns
+++ b/man/2/newns
@@ -1,12 +1,13 @@
 .TH NEWNS 2
 .SH NAME
-newns \- build a new name space from a description file
+Newns: newns, newuser \- build a new name space from a description file
 .SH SYNOPSIS
 .EX
 include "newns.m";
 ns := load Newns Newns->PATH;
 
-newns:  fn(user: string, nsfile: string): string;
+newns:   fn(user: string, nsfile: string): string;
+newuser: fn(user: string, cap: string, nsfile: string): string;
 .EE
 .SH DESCRIPTION
 .B Newns
@@ -23,12 +24,28 @@ or empty, then
 .B newns
 attempts to read file the file
 .BR namespace .
+.PP
+.B Newuser
+uses a capability
+.I cap
+suitable for
+.IR cap (3)
+to change the current process's user name to
+.IR user ,
+and uses
+.B newns
+and
+.I nsfile
+to build it a new name space.
+The capability is typically obtained via
+.IR factotum (4).
 .SH SOURCE
 .B /appl/lib/newns.b
 .SH SEE ALSO
 .IR sys-bind (2),
 .IR sys-chdir (2),
 .IR sys-pctl (2),
+.IR factotum (4),
 .IR namespace (6)
 .SH BUGS
 The
-- 
cgit v1.2.3