shithub: purgatorio

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