bind(1) [plan9 man page]
BIND(1) General Commands Manual BIND(1) NAME
bind, mount, unmount - change name space SYNOPSIS
bind [ option ... ] new old mount [ option ... ] servename old [ spec ] unmount [ new ] old DESCRIPTION
Bind and mount modify the file name space of the current process and other processes in the same name space group (see fork(2)). For both calls, old is the name of an existing file or directory in the current name space where the modification is to be made. For bind, new is the name of another (or possibly the same) existing file or directory in the current name space. After a successful bind, the file name old is an alias for the object originally named by new; if the modification doesn't hide it, new will also still refer to its original file. The evaluation of new (see intro(2)) happens at the time of the bind, not when the binding is later used. The servename argument to mount is the name of a file that, when opened, yields an existing connection to a file server. Almost always, servename will be a file in /srv (see srv(3)). In the discussion below, new refers to the file named by the new argument to bind or the root directory of the service available in servename after a mount. Either both old and new files must be directories, or both must not be directories. Options control aspects of the modification to the name space: (none) Replace the old file by the new one. Henceforth, an evaluation of old will be translated to the new file. If they are directo- ries (for mount, this condition is true by definition), old becomes a union directory consisting of one directory (the new file). -b Both files must be directories. Add the new directory to the beginning of the union directory represented by the old file. -a Both files must be directories. Add the new directory to the end of the union directory represented by the old file. -c This can be used in addition to any of the above to permit creation in a union directory. When a new file is created in a union directory, it is placed in the first element of the union that permits creation. The spec argument to mount is passed in the attach(5) message to the server, and selects among different file trees served by the server. The srv(3) service registry device, normally bound to /srv, is a convenient rendezvous point for services that can be mounted. After boot- strap, the file /srv/boot contains the communications port to the file system from which the system was loaded. The effects of bind and mount can be undone with the unmount command. If two arguments are given to unmount, the effect is to undo a bind or mount with the same arguments. If only one argument is given, everything bound to or mounted upon old is unmounted. EXAMPLES
To compile a program with the C library from July 16, 1992: mount /srv/boot /n/dump dump bind /n/dump/1992/0716/mips/lib/libc.a /mips/lib/libc.a mk SOURCE
/sys/src/cmd/bind.c /sys/src/cmd/mount.c /sys/src/cmd/unmount.c SEE ALSO
bind(2), open(2), srv(3), srv(4) BIND(1)
Check Out this Related Man Page
NAMESPACE(4) Kernel Interfaces Manual 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 holders for mounted services and directories. /mnt A directory containing mount points for applications. /n A directory containing mount points for file trees imported from remote systems. /68020 /386 /sparc /960 /mips Each CPU architecture supported by Plan 9 has a directory in the root containing architecture-specific files, to be selected accord- ing to $objtype or $cputype (see 2c(1) and init(8)). Here we list only those for /mips. /mips/init The initialization program used during bootstrapping; see init(8). /mips/bin Directory containing binaries for the MIPS architecture. /mips/bin/aux /mips/bin/games etc. Subdirectories of /mips/bin containing auxiliary 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. /rc/lib/rcmain Startup code for rc(1). /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 establish the default name space; see namespace(6). /lib/font/bit Bitmap font files. /lib/font/hershey Vector font files. /sys System software. /sys/include Directory of machine-independent C include files. /sys/include/alef Directory of ALEF include files. /sys/lib Pieces of programs not easily held in the various bins. /sys/lib/acid Directory of acid(1) load modules. /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. /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. /sys/src/alef Source for ALEF compilers and libraries. /sys/src/alef/lib Source for ALEF libraries. /mail Directory of electronic mail; see mail(1). /mail/box Directory of users' mail box files. /mail/lib Directory of alias files, etc. /acme Directory of tools for acme(1). /cron Directory of files for cron(8). 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 con- taining the appropriate executables for the current 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 win- dow system, 81/2(1), prefixes this directory with its own version, overriding many device files with its own, multiplexed simula- tions 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 processes. /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/81/2 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) NAMESPACE(4)