NAMESPACE(4)                                         NAMESPACE(4)

     NAME
          namespace - structure of conventional file name space

     SYNOPSIS
          none

     DESCRIPTION
          After a user's profile has run, the file name space should
          adhere to a number of conventions if the system is to behave
          normally.  This manual page documents those conventions by
          traversing the file hierarchy and describing the points of
          interest.  It also serves as a guide to where things reside
          in the file system proper.  The traversal is far from
          exhaustive.

          First, here is the appearance of the file server as it
          appears before any mounts or bindings.

          /             The root directory.
          /adm          The administration directory for the file
                        server.
          /adm/users    List of users known to the file server; see
                        users(6).
          /adm/keys     Authentication keys for users.
          /adm/netkeys  SecureNet keys for users; see securenet(8).
          /adm/timezone Directory of timezone files; see ctime(2).
          /adm/timezone/EST.EDT
                        Time zone description for Eastern Time.  Other
                        such files are in this directory too.
          /adm/timezone/timezone
                        Time zone description for the local time zone;
                        a copy of one of the other files in this
                        directory.
          /bin
          /dev
          /env
          /fd
          /net
          /proc
          /srv
          /tmp          All empty unwritable directories, place hold-
                        ers for mounted services and directories.
          /mnt          A directory containing mount points for appli-
                        cations.
          /n            A directory containing mount points for file
                        trees imported from remote systems.
          /68020
          /386
          /sparc
          /960

     Page 1                       Plan 9            (printed 12/22/24)

     NAMESPACE(4)                                         NAMESPACE(4)

          /hobbit
          /mips         Each CPU architecture supported by Plan 9 has
                        a directory in the root containing
                        architecture-specific files, to be selected
                        according to $objtype or $cputype (see 2c(1)
                        and init(8)). Here we list only those for
                        /mips.
          /mips/init    The initialization program used during boot-
                        strapping; see init(8).
          /mips/bin     Directory containing binaries for the MIPS
                        architecture.
          /mips/bin/aux
          /mips/bin/games
          etc.          Subdirectories of /mips/bin containing auxil-
                        iary tools and collecting related programs.
          /mips/lib     Directory of object code libraries as used by
                        vl (see 2l(1)).
          /mips/include Directory of MIPS-specific C include files.
          /mips/9*      The files in /mips beginning with a 9 are
                        binaries of the operating system.
          /mips/mkfile  Selected by mk(1) when $objtype is mips, this
                        file configures mk to compile for the MIPS
                        architecture.
          /rc           Isomorphic to the architecture-dependent
                        directories, this holds executables and
                        libraries for the shell, rc(1).
          /rc/bin       Directory of shell executable files.
          /rc/lib       Directory of shell libraries.  Holds only one
                        file, rcmain.
          /lib          Collections of data, generally not parts of
                        programs.
          /lib/bible    The King James edition
          /lib/chess
          /lib/sky
          etc.          Databases.
          /lib/ndb      The network database used by the networking
                        software; see ndb(6) and ndb(8).
          /lib/namespace
                        The file used by newns (see auth(2)) to estab-
                        lish the default name space; see namespace(6).
          /sys          System software.
          /sys/lib      Pieces of programs not easily held in the var-
                        ious bins.
          /sys/lib/troff
                        Directory of troff(1) font tables and macros.
          /sys/lib/yaccpar
                        The yacc(1) parser.
          /sys/man      The manual.
          /sys/doc      Other system documentation.
          /sys/log      Log files created by various system services.
          /sys/src      Top-level directory of system sources.
          /sys/src/cmd  Source to the commands in the bin directories.

     Page 2                       Plan 9            (printed 12/22/24)

     NAMESPACE(4)                                         NAMESPACE(4)

          /sys/src/9    Source to the operating system for terminals
                        and CPU servers.
          /sys/src/fs   Source to the operating system for file
                        servers.
          /sys/src/lib* Source to the libraries.
          /mail         Directory of electronic mail; see mail(1).
          /mail/box     Directory of users' mail box files.
          /mail/lib     Directory of alias files, etc.
          /mail/log     Directory of mail log files.
          /mail/log/status
                        Log of mail activity.

          The following files and directories are modified in the
          standard name space, as defined by /lib/namespace (see
          namespace(6)).

          /             The root of the name space.  It is a kernel
                        device, root(3), serving a number of local
                        mount points such as /bin and /dev as well as
                        the bootstrap program /boot.  Unioned with /
                        is the root of the main file server.
          /boot         Compiled into the operating system kernel,
                        this file establishes the connection to the
                        main file server and starts init; see boot(8)
                        and init(8).
          /bin          Mounted here is a union directory composed of
                        /$objtype/bin, /rc/bin, $home/$objtype/bin,
                        etc., so /bin is always the directory contain-
                        ing the appropriate executables for the cur-
                        rent architecture.
          /dev          Mounted here is a union directory containing
                        I/O devices such as the console (cons(3)), the
                        bitmap display (bit(3)), etc.  The window sys-
                        tem, 8½(1), prefixes this directory with its
                        ownn version, overriding many device files
                        with its own, multiplexed simulations of them.
          /env          Mounted here is the environment device,
                        env(3), which holds environment variables such
                        as $cputype.
          /net          Mounted here is a union directory formed of
                        all the network devices available.
          /net/cs       The communications point for the connection
                        server, ndb/cs (see ndb(8)).
          /net/il
          /net/tcp
          /net/udp      Directories holding the IP protocol devices
                        (see ip(3)).
          /net/dk       A directory holding the Datakit protocol
                        devices (see dk(3)).
          /proc         Mounted here is the process device, proc(3),
                        which provides debugging access to active pro-
                        cesses.

     Page 3                       Plan 9            (printed 12/22/24)

     NAMESPACE(4)                                         NAMESPACE(4)

          /fd           Mounted here is the dup device, dup(3), which
                        holds pseudonyms for open file descriptors.
          /srv          Mounted here is the service registry, srv(3),
                        which holds connections to file servers.
          /srv/boot     The communication channel to the main file
                        server for the machine.
          /mnt/8½       Mount point for the window system.
          /mnt/term     Mount point for the terminal's name space as
                        seen by the CPU server after a cpu(1) command.
          /n/kremvax    A place where machine kremvax's name space may
                        be mounted.
          /tmp          Mounted here is each user's private tmp,
                        $home/tmp.

     SEE ALSO
          intro(1), namespace(6)

     Page 4                       Plan 9            (printed 12/22/24)