shithub: purgatorio

ref: f8935b5778397074d41a48205e5c7f87d7b531fe
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)