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 normally. 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 particular volume spec when none is given. Most of them will not announce if this flag is not used. For example, this might be used 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 system. 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 comming from the kernel. This includes also mousefs(4), kbdfs(4), the user clipboard and selection files. /n            Set of dynamic mount points for remote applications 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/portsportfs(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 volumes known, together with volume configuration files. /lib/namespace The file used by newns (see auth(2)) to establish 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). /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 persons. 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)

Copyright © 2008 Lucent Technologies. All rights reserved.