sys/man/4/namespace

   1 .TH NAMESPACE 4
   2 .SH NAME
   3 namespace \- structure of conventional file name space
   4 .SH SYNOPSIS
   5 none
   6 .SH DESCRIPTION
   7 After a user's profile has run, the file name space should adhere
   8 to a number of conventions if the system is to behave normally.
   9 This manual page documents those conventions by traversing the
  10 file hierarchy and describing the points of interest.
  11 It also serves as a guide to where things reside in the file system proper.
  12 The traversal is far from exhaustive.
  13 .PP
  14 First, here is the appearance of the file server as it appears before
  15 any mounts or bindings.
  16 .TF /sys/src/cmd
  17 .TP
  18 .B /
  19 The root directory.
  20 .TP
  21 .B /adm
  22 The administration directory for the file server.
  23 .TP
  24 .B /adm/users
  25 List of users known to the file server; see
  26 .IR users (6).
  27 .TP
  28 .B /adm/keys
  29 Authentication keys for users.
  30 .TP
  31 .B /adm/netkeys
  32 SecureNet keys for users; see
  33 .IR securenet (8).
  34 .TP
  35 .B /adm/timezone
  36 Directory of timezone files; see
  37 .IR ctime (2).
  38 .TP
  39 .B /adm/timezone/EST.EDT
  40 Time zone description for Eastern Time.  Other such files are in this directory too.
  41 .TP
  42 .B /adm/timezone/timezone
  43 Time zone description for the local time zone; a copy of one of the other files in this directory.
  44 .TP
  45 .B /bin
  46 .TP
  47 .B /dev
  48 .TP
  49 .B /env
  50 .TP
  51 .B /fd
  52 .TP
  53 .B /net
  54 .TP
  55 .B /proc
  56 .TP
  57 .B /srv
  58 .TP
  59 .B /shr
  60 .TP
  61 .B /tmp
  62 All empty unwritable directories, place holders for mounted services and directories.
  63 .TP
  64 .B /mnt
  65 A directory containing mount points for applications.
  66 .TP
  67 .B /n
  68 A directory containing mount points for file trees imported from
  69 remote systems.
  70 .TP
  71 .B /386
  72 .TP
  73 .B /68000
  74 .TP
  75 .B /68020
  76 .TP
  77 .B /alpha
  78 .TP
  79 .B /arm
  80 .TP
  81 .B /mips
  82 .TP
  83 .B /power
  84 .TP
  85 .B /sparc
  86 Each CPU architecture supported by Plan 9 has a directory in the root containing
  87 architecture-specific files, to be selected according to
  88 .B $objtype
  89 or
  90 .B $cputype
  91 (see
  92 .IR 2c (1)
  93 and
  94 .IR init (8)).
  95 Here we list only those for
  96 .BR /386 .
  97 .TP
  98 .B /386/init
  99 The initialization program used during bootstrapping; see
 100 .IR init (8).
 101 .TP
 102 .B /386/bin
 103 Directory containing binaries for the Intel x86 architecture.
 104 .TP
 105 .B "/386/bin/aux
 106 .TP
 107 .B /386/bin/ip
 108 .TP
 109 etc.
 110 Subdirectories of
 111 .B /386/bin
 112 containing auxiliary tools and collecting related programs.
 113 .TP
 114 .B /386/lib
 115 Directory of object code libraries as used by
 116 .B 8l
 117 (see
 118 .IR 2l (1)).
 119 .TP
 120 .B /386/include
 121 Directory of x86-specific C include files.
 122 .TP
 123 .B /386/9*
 124 The files in
 125 .B /386
 126 beginning with a
 127 .B 9
 128 are binaries of the operating system or its bootstrap loader.
 129 .TP
 130 .B /386/mkfile
 131 Selected by
 132 .IR mk (1)
 133 when
 134 .B $objtype
 135 is
 136 .BR 386 ,
 137 this file configures
 138 .B mk
 139 to compile for the Intel x86 architecture.
 140 .TP
 141 .B /rc
 142 Isomorphic to the architecture-dependent directories, this holds executables
 143 and libraries for the shell,
 144 .IR rc (1).
 145 .TP
 146 .B /rc/bin
 147 Directory of shell executable files.
 148 .TP
 149 .B /rc/lib
 150 Directory of shell libraries.
 151 .TP
 152 .B /rc/lib/rcmain
 153 Startup code for
 154 .IR rc (1).
 155 .TP
 156 .B /rc/lib/rcmain.local
 157 Site local startup code for
 158 .IR rc (1).
 159 .TP
 160 .B /lib
 161 Collections of data, generally not parts of programs.
 162 .TP
 163 .B /lib/mammals
 164 .TP
 165 .B /lib/sky
 166 .TP
 167 etc.
 168 Databases.
 169 .TP
 170 .B /lib/ndb
 171 The network database used by the networking software; see
 172 .IR ndb (6)
 173 and
 174 .IR ndb (8).
 175 .TP
 176 .B /lib/namespace
 177 The file used by
 178 .B newns
 179 (see
 180 .IR auth (2))
 181 to establish the default name space; see
 182 .IR namespace (6).
 183 .TP
 184 .B /lib/font/bit
 185 Bitmap font files.
 186 .TP
 187 .B /lib/font/hershey
 188 Vector font files.
 189 .TP
 190 .B /lib/rfc
 191 Directory of Internet `Requests For Comments',
 192 ranging from trivia to specifications.
 193 .TP
 194 .B /lib/rfc/grabrfc
 195 Maintains RFC collection; usually run from
 196 .IR cron
 197 (see
 198 .IR auth (8)).
 199 .TP
 200 .B /sys
 201 System software.
 202 .TP
 203 .B /sys/include
 204 Directory of machine-independent C include files.
 205 .TP
 206 .B /sys/lib
 207 Pieces of programs not easily held in the various
 208 .BR bins .
 209 .TP
 210 .B /sys/lib/acid
 211 Directory of
 212 .IR acid (1)
 213 load modules.
 214 .TP
 215 .B /sys/lib/dist
 216 Software used to assemble the distribution's installation floppy.
 217 .TP
 218 .B /sys/lib/troff
 219 Directory of
 220 .IR troff (1)
 221 font tables and macros.
 222 .TP
 223 .B /sys/lib/yaccpar
 224 The
 225 .IR yacc (1)
 226 parser.
 227 .TP
 228 .B /sys/man
 229 The manual.
 230 .TP
 231 .B /sys/doc
 232 Other system documentation.
 233 .TP
 234 .B /sys/log
 235 Log files created by various system services.
 236 .TP
 237 .B /sys/src
 238 Top-level directory of system sources.
 239 .TP
 240 .B /sys/src/cmd
 241 Source to the commands in the
 242 .B bin
 243 directories.
 244 .TP
 245 .B /sys/src/9
 246 Source to the operating system for terminals and CPU servers.
 247 .TP
 248 .B /sys/src/fs
 249 Source to the operating system for file servers.
 250 .TP
 251 .B /sys/src/lib*
 252 Source to the libraries.
 253 .TP
 254 .B /usr
 255 A directory containing home directories of users.
 256 .TP
 257 .B /mail
 258 Directory of electronic mail; see
 259 .IR mail (1).
 260 .TP
 261 .B /mail/box
 262 Directory of users' mail box files.
 263 .TP
 264 .B /mail/lib
 265 Directory of alias files, etc.
 266 .TP
 267 .B /acme
 268 Directory of tools for
 269 .IR acme (1).
 270 .TP
 271 .B /cron
 272 Directory of files for
 273 .IR cron (8).
 274 .TP
 275 .BI /cfg/ system
 276 .IR System -specific
 277 files, often addenda to their namesakes,
 278 notably
 279 .BR cpurc ,
 280 .BR termrc ,
 281 .BR namespace ,
 282 and
 283 .BR consoledb .
 284 .PD
 285 .PP
 286 The following files and directories are modified in the standard
 287 name space, as defined by
 288 .B /lib/namespace
 289 (see
 290 .IR namespace (6)).
 291 .TF /sys/src/cmd
 292 .TP
 293 .B /
 294 The root of the name space.  It is a kernel device,
 295 .IR root (3),
 296 serving a number of local mount points such as
 297 .B /bin
 298 and
 299 .B /dev
 300 as well as the bootstrap program
 301 .BR /boot .
 302 Unioned with
 303 .B /
 304 is the root of the main file server.
 305 .TP
 306 .B /boot
 307 Compiled into the operating system kernel, this file establishes
 308 the connection to the main file server and starts
 309 .BR init ;
 310 see
 311 .IR boot (8)
 312 and
 313 .IR init (8).
 314 .TP
 315 .B /bin
 316 Mounted here is a union directory composed of
 317 .BR /$objtype/bin ,
 318 .BR /rc/bin ,
 319 .BR $home/$objtype/bin ,
 320 etc., so
 321 .B /bin
 322 is always the directory containing the appropriate executables
 323 for the current architecture.
 324 .TP
 325 .B /dev
 326 Mounted here is a union directory containing I/O devices such as the
 327 console
 328 .RI ( cons (3)),
 329 the interface to the raster display
 330 .RI ( draw (3)),
 331 etc.
 332 The window system,
 333 .IR rio (1),
 334 prefixes
 335 this directory with its own version,
 336 overriding many device
 337 files with its own, multiplexed simulations of them.
 338 .TP
 339 .B /env
 340 Mounted here is the environment device,
 341 .IR env (3),
 342 which holds environment variables such as
 343 .BR $cputype .
 344 .TP
 345 .B /net
 346 Mounted here is a union directory formed of all the network devices
 347 available.
 348 .TP
 349 .B /net/cs
 350 The communications point for the connection server,
 351 .B ndb/cs
 352 (see
 353 .IR ndb (8)).
 354 .TP
 355 .B /net/dns
 356 The communications point for the Domain Name Server,
 357 .B ndb/dns
 358 (see
 359 .IR ndb (8)).
 360 .TP
 361 .B /net/tcp
 362 .TP
 363 .B /net/udp
 364 Directories holding the IP protocol devices
 365 (see
 366 .IR ip (3)).
 367 .TP
 368 .B /proc
 369 Mounted here is the process device,
 370 .IR proc (3),
 371 which provides debugging access to active processes.
 372 .TP
 373 .B /fd
 374 Mounted here is the dup device,
 375 .IR dup (3),
 376 which holds pseudonyms for open file descriptors.
 377 .TP
 378 .B /shr
 379 Mounted here is the global mountpoint device,
 380 .IR shr (3),
 381 which holds mounted filesystems visible in all namespaces.
 382 .TP
 383 .B /srv
 384 Mounted here is the service registry,
 385 .IR srv (3),
 386 which holds connections to file servers.
 387 .TP
 388 .B /srv/boot
 389 The communication channel to the main file server for the machine.
 390 .TP
 391 .B /mnt/wsys
 392 Mount point for the window system.
 393 .TP
 394 .B /mnt/term
 395 Mount point for the terminal's name space as seen by the CPU server
 396 after a
 397 .IR cpu (1)
 398 command.
 399 .TP
 400 .B /n/kremvax
 401 A place where machine
 402 .BR kremvax 's
 403 name space may be mounted.
 404 .TP
 405 .B /tmp
 406 Mounted here is each user's private
 407 .B tmp,
 408 .BR $home/tmp .
 409 .SH SEE ALSO
 410 .IR intro (1),
 411 .IR namespace (6)