code: purgatorio

ref: 27598a9c874c115795a3d59de093f8f158a73d87
dir: /man/2/newns/

View raw version
.TH NEWNS 2
.SH NAME
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;
newuser: fn(user: string, cap: string, nsfile: string): string;
.EE
.SH DESCRIPTION
.B Newns
reads file
.I nsfile
and builds a new name space based on the commands it contains.
The file has the format defined by
.IR namespace (6).
If
.I nsfile
is
.B nil
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)