v1 state

DemoKey

DemoKey names the namespace gnoweb browses when no ?u= is given. It is a plain string rather than an address so it can never collide with one.

MaxServices

The bounds on what callers can create. Any realm may Post a service and any account gets a namespace on its first Exec; the home page lists both.

MaxNamespaces

The bounds on what callers can create. Any realm may Post a service and any account gets a namespace on its first Exec; the home page lists both.

HomeRecent

// namespaces the home page lists

service

space

services

// name -> \*service

spaces

// address string (or DemoKey) -> \*space

init.8

srvDir

srvDir is the synthetic directory that makes posted services reachable by name. It is written out by hand rather than built with synfs because its contents change as realms post, and because implementing ninep.File directly is meant to look easy: four methods, no state of its own.

srvRoot

Post

Post publishes a file tree under name in /srv, where any account can bind it. The posting realm is recorded and is the only one that may Unpost. Names are first come, first served, which is fine for an experiment and would not be for anything else.

Unpost

Unpost withdraws a service. Only the realm that posted it may do so.

Services

Services lists the posted service names, in order.

newSpace

newSpace builds the default namespace, which is this chain's /lib/namespace: a private ram root, the mount points that Plan 9 requires to exist before anything can be bound onto them, /srv mounted, and /dev bound from it when a device server has been posted.

spaceFor

peek

seedDemo

seedDemo builds the namespace gnoweb shows by default. It is deliberately reproducible: an example test resets it before rendering.

ResetDemo

ResetDemo rebuilds the demo namespace. Anyone may call it: it is a demo, and the alternative is a demo that the first visitor ruins for everybody.

Exec

Exec runs a command line against the CALLER's namespace and returns its output. The namespace belongs to cur.Previous().Address(), so a user gets theirs and a realm gets its own. An error panics, so a half-applied command line reverts with the transaction rather than leaving a namespace nobody asked for.

Reset

Reset discards the caller's namespace, so the next use rebuilds the default.

Run

Run executes a READ-ONLY command line against key's namespace. It is the query side of Exec: no transaction, no writes, safe from Render.

Namespace

Namespace returns key's mount table, in ns(1) format.

Keys

Keys lists the namespaces that exist, in order.

Render

Render browses a namespace. Render("") overview, posted services, how to drive it Render("ns?u=<key>") the mount table Render("ls/bin?u=<key>") a directory listing (ls -l) Render("cat/tmp/greeting") a file Render("stat/bin") the 9P stat, with the union width Render("walk/bin/rc") how each element of a path resolves Render("rc?c=<command>") any read-only rc command line ?u= selects the namespace; it defaults to the demo one.

renderCmd

renderHome

quote

quote wraps a path for rc if it needs it.