ref: 02b0b4dfb5a5bcc8971d5c15b2e9761b3fb59508
dir: /sys/man/4/namespace/
.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 /shr .TP .B /tmp All empty unwritable directories, place holders for mounted services and directories. .TP .B /mnt A directory containing mount points for applications. .TP .B /n A directory containing mount points for file trees imported from remote systems. .TP .B /386 .TP .B /68000 .TP .B /68020 .TP .B /alpha .TP .B /arm .TP .B /mips .TP .B /power .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 or its bootstrap loader. .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 /rc/lib/rcmain.local Site local 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/ttf TrueType font files. .TP .B /lib/rfc Directory of Internet `Requests For Comments', ranging from trivia to specifications. .TP .B /lib/rfc/grabrfc Maintains RFC collection; usually run from .IR cron (see .IR auth (8)). .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 /usr A directory containing home directories of users. .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). .TP .BI /cfg/ system .IR System -specific files, often addenda to their namesakes, notably .BR cpurc , .BR termrc , .BR namespace , and .BR consoledb . .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/bin/$objtype , .BR $home/bin/rc , 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/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 /shr Mounted here is the global mountpoint device, .IR shr (3), which holds mounted filesystems visible in all namespaces. .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 rcpu (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)