NAMESPACE(4)                                         NAMESPACE(4)

     NAME
          namespace, ons - octopus name space and conventions

     DESCRIPTION
          In the octopus, there are several name space conventions and
          programs rely on them. This manual page documents such
          conventions.  Besides, depending on where the namespace is
          used, it is sensible to adhere to Inferno or to the host OS
          (eg. Plan 9) conventions as well.

          The script ons adjusts the Inferno name space to adhere the
          octopus conventions.

          There are several name spaces of interest, depending on
          where the application executes (or where are we browsing
          files from). Most times, applications and browsed files
          belong to the host system of the PC (eg., Plan 9). The next
          subsection documents such name space. A following section
          documents the name space as found on the Inferno running at
          the PC.

        PC Name space
          This section assumens the PC host system is Plan 9 from Bell
          Labs. Adjustment of name spaces in other native host systems
          is not yet supported, although it will be in the future.

          Most conventions of Plan 9 name spaces hold, like using /bin
          for binaries and /usr for user files.  The following files
          and directories are also available when using the PC from
          the Octopus:

          /dev/snarf           The clipboard. Usually it is an actual
                               file at bound to along with the next
                               file.
          /dev/sel             contains the path for the (user inter-
                               face) panel where a selection was last
                               made. The file is kept at
                               $home/lib/snarf/sel or a similar place
                               and bound to /dev like before.
          /mnt                 contains directories where different
                               resources added to the PC can be found.
          /mnt/ui              contains the file system interface for
                               the Octopus window system, Omero. See
                               omero(4) for a description.
          /mnt/ports           contains a directory providing the
                               event delivery mechanism used by the
                               Octopus.
          /mnt/view            is a file viewer device. To view a file
                               (e.g., a PDF) it suffices to copy it to
                               this directory. A document viewer at a

     NAMESPACE(4)                                         NAMESPACE(4)

                               terminal near the user (probably one at
                               the terminal being used to request the
                               copy) will be launched as a result of
                               the copy.
          /mnt/view/ndb        is a text file describing properties of
                               the view device. Among other things it
                               describes the location of the device
                               and the terminal providing it.
          /mnt/print           is a printing device. To print a file,
                               copy it to this directory. The file
                               will be printed at the default printer
                               queue provided by a terminal near the
                               user.
          /mnt/print/ndb       describes the print device. All devices
                               include an ndb file by convention
                               (although we will not mention it fur-
                               ther).
          /mnt/print/voice     is a voice synthesis device. To speak
                               some text, copy it to the speak file it
                               provides. As all other devices mounted
                               at /mnt the device used will be one
                               near the user.
          /mnt/terms/terminal  is a directory where devices and
                               resources from the machine terminal can
                               be found. There are multiple terminals
                               mounted below /mnt/terms in the same
                               way.  We mention some devices next, but
                               not all of them would be provided by
                               all terminals. The devices found
                               directly at /mnt come indeed from the
                               ones we mention here.
          /mnt/terms/terminal/view
                               is the view device provided by the ter-
                               minal.
          /mnt/terms/terminal/print
                               is the print device from that terminal.
          /mnt/terms/terminal/voice
                               is its voice synthesis device.
          /mnt/terms/terminal/fs
                               contains the file system from sysname
                               (from its native OS, not from the
                               Inferno it runs).  This can be used to
                               transfer files back and forth between
                               the PC and the terminal.
          /n/pc                contains the name space of the Inferno
                               running at the PC. All resources
                               described before in this list come from
                               this file tree.
          /what                contains information about machines.
          /what/machine        contains information about the system
                               named machine.
          /what/machine/where  contains the machine location.

     NAMESPACE(4)                                         NAMESPACE(4)

          /what/machine/radius contains the RTT for performing a par-
                               ticular FS operation on the machine
                               from the PC.
          /what/machine/owner  contains the name of the user owning
                               the machine.
          /who                 contains information about users.
          /who/user            contains information about user user.
          /who/user/where      contains the last known location for
                               the user.
          /who/user/last       contains the name of the last terminal
                               used by this user.
          /who/user/status     contains the status of the user. It is
                               usually on of online, busy, or away.

        PC Inferno name space
          The name space space at the Inferno running on the PC is
          similar to that of any other Inferno installation, but
          includes the following files and directories. Unless said
          otherwise, the directories mean the same the do in the name
          space of the PC.

                           TP /dis/o contains the Dis binaries for the
                           Octopus.
          /dis/o/$emuhost  contains Dis binaries for the Octopus
                           intended for the host system represented by
                           the $emuhost variable. This directory is
                           bound also at /dis to add platform depen-
                           dent binaries to the portable ones.
          /mnt/registry    is the mount point for the registry,
                           describing resources known by the Octopus.
          /mnt/ui
          /mnt/ports
          /mnt/snarf       contains the snarf and sel files found at
                           /dev in the PC.
          /mnt/view
          /mnt/print
          /mnt/voice
          /mnt/fs          contains the PC name space, including the
                           files described before for the PC.
          /mnt/what        is the PC /what directory, and contains
                           information about machines.
          /mnt/who         is the PC /who directory and contains
                           information about users.
          /terms           is similar to /mnt/terms in the PC.

        Terminal name space
          The name space at the Inferno running on a terminal has the
          file tree of the PC's Inferno at /pc (using the Octopus pro-
          tocol as the file protocol) and also at /n/pc (using Styx as
          the file protocol). The former works better on poor network
          connections but the later is closer to expected semantics
          for file access. Also, /mnt/registry /mnt/snarf and other

     NAMESPACE(4)                                         NAMESPACE(4)

          devices from the PC are available for use by terminal soft-
          ware.

     SOURCE
          /usr/octopus/port/ons

     SEE ALSO
          nsbuild(1), wm(1), newns(2)