Advanced Namespace Tools for Plan 9
glenda 2eb48358b3 update fqa with 9front divergences 1 year ago
bootdir.extras add ipparams echo setup to boot scripts 1 year ago
cfg restructure and cleanup build script, remove xd from toolcopy 1 year ago
diffs update gridlisten to current 9front version 1 year ago
doc update fqa with 9front divergences 1 year ago
frontmods restore accidentally dropped patch of hgrc annoyance 1 year ago
grio add sl rio background color patch 1 year ago
hubfs fix long standing hubfs wraparound corner case bug 1 year ago
patched add mountpoint parameter to gridlisten1 1 year ago
root restructure ants repo to 9front only 1 year ago
scripts update gridstart 1 year ago
sys/man update manpage source locations 1 year ago
.hgignore restructure ants repo to 9front only 1 year ago
GUIDE restructure ants repo to 9front only 1 year ago
INDEX add repository reorg blog post and remove some labs related doc info 1 year ago
INSTALLING draft of ants fqa 1 year ago
LICENSE add libventi diffs from 9legacy 1 year ago
README adjust srv name in fossil/venti mount scripts, doc tweaks 1 year ago
ants.html web docs adjustments 1 year ago
build readd portsinstall, portsuninstall build targets 1 year ago
index.html web docs adjustments 1 year ago


- Advanced Namespace Tools for 9front -

This is a toolkit of additions and modifications to Plan 9. It is
designed to make Plan 9 installations, on single machines or on
networks, more flexible. ANTS has:

* A modified boot process which creates an isolated administrative
namespace independent of any root fileserver.

* A modified kernel which accepts manipulation of process namespace
via writes of standard namespace operations to the /proc/PID/ns files

* Kernel mod and rc patch to allow rfork V into a new /srv namespace

* Scripts for moving between and systematically altering namespaces
such as "rerootwin" which is similar to chroot in unix and keeps the
terminal devices at /mnt/term active.

* Optional fossil/venti support with administrative scripts for
progressive backup/replication and maintaining a log of rootscores

* Hubfs 9p fs for networked persistent shell sessions and a
lightweight general purpose multiclient read/write buffered message
queue with pipelike hubfiles

* Grio modified Rio with customizable appearance for color-coded
namespace grouping, user-selectable additional menu command, and hubfs

Most of these components are synergistic, but not interdependent. The
userspace programs and utilities do not generally depend on using the
modified ANTS kernel.

- Installing on 9front from source -

Check that your 9front hg revision matched up with a compatible ANTS
revision. The most recent tested 9front revision is the 5736 Feb2017
release. Previously tested ANTS/9front revisions are listed in the
INSTALLING file.The build script has a variety of possible targets. A
basic sequence:

# compile everything but install nothing yet
build 9front
# install userspace components but not kernel/9fat
build fronthost
# copy new kernel and tools to 9fat partition
9fs 9fat && cp 9ants /n/9fat && cp tools.tgz /n/9fat
# add one line to /rc/bin/termrc for gui/terminal service
echo 'home=/usr/$user; cd; . $home/lib/profile' >>/rc/bin/termrc
# edit plan9.ini
acme /n/9fat/plan9.ini

To allow you to select between kernels at boot, you can set bootfile=
in plan9.ini to not provide a value. Then at boot you will have to
type "bootfile=9ants" or "bootfile=9pcf" (assuming that is your
original kernel name) and then "boot". You may want to set
"bootcmd=plan9rc". if you set "privpassword=" to something in
plan9.ini, a cpu listener on port 17060 will be started to allow
hostowner cpu/drawterm to the ants boot/admin namespace.
cfg/plan9.ini has a minimal example that works with a fresh cwfs
install to a qemu vm.

You may also wish to change "rio" to "grio" in your profile.

- Using 9front/ANTS -

The behavior of the standard user namespace should be unchanged, apart
from the use of grio rather rio if desired. To access the special
service namespace, either rcpu in (the default port is 17060) or, if
using a terminal system, "hub hubfs" to connect to a peristent shell
in that namespace. When connecting to the service namespace via
Drawterm, add the -B flag. From within the service namespace, you may
enter the standard namespace with this sequence:

rerootwin -f boot
. $home/lib/profile

With bootcmd=plan9rc set in plan9.ini, ANTS supports additional boot
options, such as fossil+venti (requires installing fossil,
partitioning hard drive correctly, and setting plan9.ini options.) or
fully interactive boot with prompts for all options (with
interactive=yes in plan9.ini).

Additional documentation found in the INSTALLING file and in the doc/