[MIRROR] Advanced Namespace Tools for Plan 9 http://ants.9gridchan.org/
glenda a04d5407ca update web info for 4.99 release 7 months ago
bootdir.extras edit plan9rc output a bit more 7 months ago
cfg add sysname to clean score store in spawncfg 7 months ago
diffs update pc/pc64 to match 9front tip 7 months ago
doc update web info for 4.99 release 7 months ago
extra add griddisk and adjust gridstart script to use it instead of gridftp as default 7 months ago
frontmods 9spawn transfer release attempt 7 months ago
grid restore sleep 1 in gridorc 7 months ago
grio grio: allow background change via wctl, thx mischief/moody 7 months ago
hubfs hubshell rewrite, thanks burnzez! 7 months ago
patched add zrv to devroot and patch lib9p srv.c and namespace files 8 months ago
root restructure ants repo to 9front only 1 year ago
scripts make fn cpl in gridstart target cpl subdir 7 months ago
sys/man change hubshell echoes default 8 months ago
.hgignore restructure ants repo to 9front only 1 year ago
GUIDE minor documentation adjustments to guide, installing, license files 8 months ago
INDEX add repository reorg blog post and remove some labs related doc info 1 year ago
INSTALLING 9spawn transfer release attempt 7 months ago
LICENSE minor documentation adjustments to guide, installing, license files 8 months ago
README update docs to 4.3 prerelease 8 months ago
ants.html web docs adjustments 1 year ago
build add modded namespace and adjust buildscript, fix spawncfg typo 7 months ago
index.html update web info for 4.99 release 7 months 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=9pc" (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/