shithub: purgatorio

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