diff options
Diffstat (limited to 'static/plan9-4e/man1/bind.1')
| -rw-r--r-- | static/plan9-4e/man1/bind.1 | 201 |
1 files changed, 201 insertions, 0 deletions
diff --git a/static/plan9-4e/man1/bind.1 b/static/plan9-4e/man1/bind.1 new file mode 100644 index 00000000..a430ba5d --- /dev/null +++ b/static/plan9-4e/man1/bind.1 @@ -0,0 +1,201 @@ +.TH BIND 1 +.SH NAME +bind, mount, unmount \- change name space +.SH SYNOPSIS +.B bind +[ +.I option ... +] +.I new old +.PP +.B mount +[ +.I option ... +] +.I servename old +[ +.I spec +] +.PP +.B unmount +[ +.I new +] +.I old +.SH DESCRIPTION +.I Bind +and +.I mount +modify the file name space of the current process +and other processes in the same name space group +(see +.IR fork (2)). +For both calls, +.I old +is the name of an existing file or directory in the +current name space where the modification is to be made. +.PP +For +.IR bind , +.I new +is the name of another (or possibly the same) +existing file or directory in +the current name space. +After a successful +.IR bind , +the file name +.I old +is an alias for the object originally named by +.IR new ; +if the modification doesn't hide it, +.I new +will also still refer to its original file. +The evaluation of +.I new +(see +.IR intro (2)) +happens at the time of the +.IR bind , +not when the binding is later used. +.PP +The +.I servename +argument to +.I mount +is the name of a file that, when opened, yields an +existing connection to a file server. +Almost always, +.I servename +will be a file in +.B /srv +(see +.IR srv (3)). +In the discussion below, +.I new +refers to the file named by the +.I new +argument to +.I bind +or the root directory of the service +available in +.I servename +after a +.IR mount . +Either both +.I old +and +.I new +files must be directories, +or both must not be directories. +.PP +Options control aspects of the modification to the name space: +.TP 10 +(none) +Replace the +.I old +file by the new one. +Henceforth, an evaluation of +.I old +will be translated to the new file. +If they are directories (for +.IR mount , +this condition is true by definition), +.I old +becomes a +.I "union directory" +consisting of one directory (the new file). +.TP +.B -b +Both files must be directories. +Add the new directory to the beginning +of the union directory represented by the old file. +.TP +.B -a +Both files must be directories. +Add the new directory to the end +of the union directory represented by the old file. +.TP +.B -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 has been bound or mounted with the +.B -c +flag. +If that directory does not have write permission, the create fails. +.TP +.B -C +(Only in +.IR mount .) +By default, file contents are always retrieved from the server. +With this option, the kernel may instead use a local cache to satisfy +.IR read (5) +requests for files accessible through this mount point. +The currency of cached data for a file is verified at each +.IR open (5) +of the file from this client machine. +.TP +.B -q +Exit silently if the +.B bind +or +.B mount +operation fails. +.PD +.PP +The +.I spec +argument to +.I mount +is passed in the +.IR attach (5) +message to the server, and selects among different +file trees served by the server. +.PP +The +.IR srv (3) +service registry device, normally bound to +.BR /srv , +is a convenient rendezvous point for services that can be mounted. +After bootstrap, the file +.B /srv/boot +contains the communications port to the file system from which +the system was loaded. +.PP +The effects of +.I bind +and +.I mount +can be undone with the +.I unmount +command. +If two arguments are given to +.IR unmount , +the effect is to undo a +.I bind +or +.I mount +with the same arguments. +If only one argument is given, +everything bound to or mounted upon +.I old +is unmounted. +.SH EXAMPLES +To compile a program with the C library from July 16, 1992: +.IP +.EX +mount /srv/boot /n/dump dump +bind /n/dump/1992/0716/mips/lib/libc.a /mips/lib/libc.a +mk +.EE +.SH SOURCE +.B /sys/src/cmd/bind.c +.br +.B /sys/src/cmd/mount.c +.br +.B /sys/src/cmd/unmount.c +.SH SEE ALSO +.IR bind (2), +.IR open (2), +.IR srv (3), +.IR srv (4) |