PLANB(4) PLANB(4)
NAME
namespace.planb, planbfs - conventions for Plan B name
spaces and volume file severs
SYNOPSIS
bns
planbfs [ -A ] [ -abc ] [ -dD ] [ -s srv ] [ -m mnt ] [ -n
addr ] [ -V volspec ]
DESCRIPTION
A Plan B environment is built by assembling multiple volume
file servers into a name space, through bns(4). All volume
file servers have a common set of options described here
using planbfs (which is not a real program) as an example.
The common behaviour found in most Plan B file servers is
also described.
Also, the file name space of a Plan B terminal should adhere
to a number of conventions if the system is to behave nor-
mally. This page documents below the Plan B specific
details, as reflected by the /lib/namespace.planb file used
during the boot process. See namespace(4) for the common
Plan 9 conventions.
Volume file severs
A planbfs program accepts 9P clients and authenticates them
if they reach the file server from a different machine (not
from a pipe or a local network address). Option -A disables
authentication.
The file server usually mounts itself at a default mount
point, or at mnt when given. Options -abc are like in
mount(1) and control the mount flag used in this case.
The network address where the file server listens for new
clients depends on the service provided by the volume. See
/lib/ndb/common for a list of Plan B TCP services. This may
be changed by supplying addr with the -n flag.
Flag -d enables debugging. Many times, debugging may be made
even more verbose by repeating the flag, or by using -D
instead.
The -V option supplies the volume spec, i.e., its global
name and set of attributes. This is used to announce the
volume. Some file servers may insist in announcing a partic-
ular volume spec when none is given. Most of them will not
announce if this flag is not used. For example, this might
be used
Page 1 Plan 9 (printed 11/5/25)
PLANB(4) PLANB(4)
omero -V /devs/ui
omero -V '/devs/ui sys=fake'
to start a window system and announce it as /devs/ui, and to
start a second one pretending to be running at a fake sys-
tem.
Some attributes, most notably user, sys, and loc will be
added by the file server to reflect the user who started the
service, the system where it runs, and the location at the
time the service was started (as known by the system). See
cnstr(6) for the conventions regarding attributes.
Plan B Name Spaces
The conventions for a Plan B name space are described now.
/mnt/plumb Mount point for sendfs(4) and portfs(4).
/dev Union of different local devices, usually com-
ming from the kernel. This includes also
mousefs(4), kbdfs(4), the user clipboard and
selection files.
/n Set of dynamic mount points for remote appli-
cations and servers. Most things are mounted
here. Some ones are described now.
/n/9 File system for Plan 9 terminals.
/n/music Music archive.
/n/once File system not archived with venti.
/devs Set of dynamic mount points for most Plan B
volumes.
/devs/audio Audio device.
/devs/voice Voice device.
/devs/sysnameui
User interface for that system.
/devs/x10 X10 switches and sensors.
/devs/hx Hexamite active badgets.
/devs/ports portfs(8) for the local machine,
/net/cs The communications point for the (caching)
connection server, ndb/ccs (see ndb(8)).
/lib/repl Configuration files for repl(1).
/lib/ndb/vol Archives created by adsrv(8) to reflect vol-
umes known, together with volume configuration
files.
/lib/namespace
The file used by newns (see auth(2)) to estab-
lish the default (Plan 9) name space; see
namespace(6).
/lib/namespace.planb
is the analog file to setup the default Plan B
name space.
/mail Directory of electronic mail; see mail(1).
/mail/box Directory of users' mail box files.
/mail/box/$user/mails
Default user's Plan B mail box. See mails(1).
Page 2 Plan 9 (printed 11/5/25)
PLANB(4) PLANB(4)
/sys/man The manual.
/sys/doc/papers
Articles documenting the system, i.e., related
to Plan B.
/sys/doc/9 Articles describing the Plan 9 system used as
the origin for the current system.
/sys/doc/talks
Slides and material for Plan B related talks
and presentations.
/sys/doc/man Printed version of the manual.
/sys/log Log files created by various system services.
/usr/inferno FIles for the Inferno operating system.
/usr/planb Files for 2nd edition Plan B.
/usr/web Web files and services.
/who Directory with context information for per-
sons. Contains a directory per user, named
after the user's login name.
/what Directory with context information for things.
Contains a directory per place (room number)
and machine (sysname). The directories for
places contain a directory per known thing at
that place, to hold its context information.
/where Directory with context information for places.
Contains a directory per place.
SEE ALSO
intro(1), namespace(4), namespace(6)
Page 3 Plan 9 (printed 11/5/25)