build: Better Build System

1 files changed, 384 insertions, 0 deletions

diff --git a/static/plan9-4e/man4/namespace.4 b/static/plan9-4e/man4/namespace.4
new file mode 100644
index 00000000..68963d35
--- /dev/null
+++ b/static/plan9-4e/man4/namespace.4
@@ -0,0 +1,384 @@
+.TH NAMESPACE 4
+.SH NAME
+namespace \- structure of conventional file name space
+.SH SYNOPSIS
+none
+.SH 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.
+.PP
+First, here is the appearance of the file server as it appears before
+any mounts or bindings.
+.TF /sys/src/cmd
+.TP
+.B /
+The root directory.
+.TP
+.B /adm
+The administration directory for the file server.
+.TP
+.B /adm/users
+List of users known to the file server; see
+.IR users (6).
+.TP
+.B /adm/keys
+Authentication keys for users.
+.TP
+.B /adm/netkeys
+SecureNet keys for users; see
+.IR securenet (8).
+.TP
+.B /adm/timezone
+Directory of timezone files; see
+.IR ctime (2).
+.TP
+.B /adm/timezone/EST.EDT
+Time zone description for Eastern Time.  Other such files are in this directory too.
+.TP
+.B /adm/timezone/timezone
+Time zone description for the local time zone; a copy of one of the other files in this directory.
+.TP
+.B /bin
+.TP
+.B /dev
+.TP
+.B /env
+.TP
+.B /fd
+.TP
+.B /net
+.TP
+.B /proc
+.TP
+.B /srv
+.TP
+.B /tmp
+All empty unwritable directories, place holders for mounted services and directories.
+.TP
+.B /mnt
+A directory containing mount points for applications.
+.B /mnt/factotum
+Mount point for
+.IR factotum (4).
+.TP
+.B /n
+A directory containing mount points for file trees imported from
+remote systems.
+.TP
+.B /29000
+.TP
+.B /386
+.TP
+.B /68000
+.TP
+.B /68020
+.TP
+.B /960
+.TP
+.B /alpha
+.TP
+.B /arm
+.TP
+.B /mips
+.TP
+.B /sparc
+Each CPU architecture supported by Plan 9 has a directory in the root containing
+architecture-specific files, to be selected according to
+.B $objtype
+or
+.B $cputype
+(see
+.IR 2c (1)
+and
+.IR init (8)).
+Here we list only those for
+.BR /386 .
+.TP
+.B /386/init
+The initialization program used during bootstrapping; see
+.IR init (8).
+.TP
+.B /386/bin
+Directory containing binaries for the Intel x86 architecture.
+.TP
+.B "/386/bin/aux
+.TP
+.B /386/bin/ip
+.TP
+etc.
+Subdirectories of
+.B /386/bin
+containing auxiliary tools and collecting related programs.
+.TP
+.B /386/lib
+Directory of object code libraries as used by
+.B 8l
+(see
+.IR 2l (1)).
+.TP
+.B /386/include
+Directory of x86-specific C include files.
+.TP
+.B /386/9*
+The files in
+.B /386
+beginning with a
+.B 9
+are binaries of the operating system.
+.TP
+.B /386/mkfile
+Selected by
+.IR mk (1)
+when
+.B $objtype
+is
+.BR 386 ,
+this file configures
+.B mk
+to compile for the Intel x86 architecture.
+.TP
+.B /rc
+Isomorphic to the architecture-dependent directories, this holds executables
+and libraries for the shell,
+.IR rc (1).
+.TP
+.B /rc/bin
+Directory of shell executable files.
+.TP
+.B /rc/lib
+Directory of shell libraries.
+.TP
+.B /rc/lib/rcmain
+Startup code for
+.IR rc (1).
+.TP
+.B /lib
+Collections of data, generally not parts of programs.
+.TP
+.B /lib/mammals
+.TP
+.B /lib/sky
+.TP
+etc.
+Databases.
+.TP
+.B /lib/ndb
+The network database used by the networking software; see
+.IR ndb (6)
+and
+.IR ndb (8).
+.TP
+.B /lib/namespace
+The file used by
+.B newns
+(see
+.IR auth (2))
+to establish the default name space; see
+.IR namespace (6).
+.TP
+.B /lib/font/bit
+Bitmap font files.
+.TP
+.B /lib/font/hershey
+Vector font files.
+.TP
+.B /sys
+System software.
+.TP
+.B /sys/include
+Directory of machine-independent C include files.
+.TP
+.B /sys/lib
+Pieces of programs not easily held in the various
+.BR bins .
+.TP
+.B /sys/lib/acid
+Directory of
+.IR acid (1)
+load modules.
+.TP
+.B /sys/lib/dist
+Software used to assemble the distribution's installation floppy.
+.TP
+.B /sys/lib/troff
+Directory of
+.IR troff (1)
+font tables and macros.
+.TP
+.B /sys/lib/yaccpar
+The
+.IR yacc (1)
+parser.
+.TP
+.B /sys/man
+The manual.
+.TP
+.B /sys/doc
+Other system documentation.
+.TP
+.B /sys/log
+Log files created by various system services.
+.TP
+.B /sys/src
+Top-level directory of system sources.
+.TP
+.B /sys/src/cmd
+Source to the commands in the
+.B bin
+directories.
+.TP
+.B /sys/src/9
+Source to the operating system for terminals and CPU servers.
+.TP
+.B /sys/src/fs
+Source to the operating system for file servers.
+.TP
+.B /sys/src/lib*
+Source to the libraries.
+.TP
+.B /mail
+Directory of electronic mail; see
+.IR mail (1).
+.TP
+.B /mail/box
+Directory of users' mail box files.
+.TP
+.B /mail/lib
+Directory of alias files, etc.
+.TP
+.B /acme
+Directory of tools for
+.IR acme (1).
+.TP
+.B /cron
+Directory of files for
+.IR cron (8).
+.PD
+.PP
+The following files and directories are modified in the standard
+name space, as defined by
+.B /lib/namespace
+(see
+.IR namespace (6)).
+.TF /sys/src/cmd
+.TP
+.B /
+The root of the name space.  It is a kernel device,
+.IR root (3),
+serving a number of local mount points such as
+.B /bin
+and
+.B /dev
+as well as the bootstrap program
+.BR /boot .
+Unioned with
+.B /
+is the root of the main file server.
+.TP
+.B /boot
+Compiled into the operating system kernel, this file establishes
+the connection to the main file server and starts
+.BR init ;
+see
+.IR boot (8)
+and
+.IR init (8).
+.TP
+.B /bin
+Mounted here is a union directory composed of
+.BR /$objtype/bin ,
+.BR /rc/bin ,
+.BR $home/$objtype/bin ,
+etc., so
+.B /bin
+is always the directory containing the appropriate executables
+for the current architecture.
+.TP
+.B /dev
+Mounted here is a union directory containing I/O devices such as the
+console
+.RI ( cons (3)),
+the interface to the raster display
+.RI ( draw (3)),
+etc.
+The window system,
+.IR rio (1),
+prefixes
+this directory with its own version,
+overriding many device
+files with its own, multiplexed simulations of them.
+.TP
+.B /env
+Mounted here is the environment device,
+.IR env (3),
+which holds environment variables such as
+.BR $cputype .
+.TP
+.B /net
+Mounted here is a union directory formed of all the network devices
+available.
+.TP
+.B /net/cs
+The communications point for the connection server,
+.B ndb/cs
+(see
+.IR ndb (8)).
+.TP
+.B /net/dns
+The communications point for the Domain Name Server,
+.B ndb/dns
+(see
+.IR ndb (8)).
+.TP
+.B /net/il
+.TP
+.B /net/tcp
+.TP
+.B /net/udp
+Directories holding the IP protocol devices
+(see
+.IR ip (3)).
+.TP
+.B /proc
+Mounted here is the process device,
+.IR proc (3),
+which provides debugging access to active processes.
+.TP
+.B /fd
+Mounted here is the dup device,
+.IR dup (3),
+which holds pseudonyms for open file descriptors.
+.TP
+.B /srv
+Mounted here is the service registry,
+.IR srv (3),
+which holds connections to file servers.
+.TP
+.B /srv/boot
+The communication channel to the main file server for the machine.
+.TP
+.B /mnt/wsys
+Mount point for the window system.
+.TP
+.B /mnt/term
+Mount point for the terminal's name space as seen by the CPU server
+after a
+.IR cpu (1)
+command.
+.TP
+.B /n/kremvax
+A place where machine
+.BR kremvax 's
+name space may be mounted.
+.TP
+.B /tmp
+Mounted here is each user's private
+.B tmp, 
+.BR $home/tmp .
+.SH SEE ALSO
+.IR intro (1),
+.IR namespace (6)