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

     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).

     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)