Annotation of lucent/sys/man/1/bind, revision 1.1.1.1

1.1       root        1: .TH BIND 1
                      2: .SH NAME
                      3: bind, mount, unmount \- change name space
                      4: .SH SYNOPSIS
                      5: .B bind
                      6: [
                      7: .I option ...
                      8: ]
                      9: .I new old
                     10: .PP
                     11: .B mount
                     12: [
                     13: .I option ...
                     14: ]
                     15: .I servename old
                     16: [
                     17: .I spec
                     18: ]
                     19: .PP
                     20: .B unmount
                     21: [
                     22: .I new
                     23: ]
                     24: .I old
                     25: .SH DESCRIPTION
                     26: .I Bind
                     27: and
                     28: .I mount
                     29: modify the file name space of the current process
                     30: and other processes in the same name space group
                     31: (see
                     32: .IR fork (2)).
                     33: For both calls,
                     34: .I old
                     35: is the name of an existing file or directory in the
                     36: current name space where the modification is to be made.
                     37: .PP
                     38: For
                     39: .IR bind ,
                     40: .I new
                     41: is the name of another (or possibly the same)
                     42: existing file or directory in
                     43: the current name space.
                     44: After a successful
                     45: .IR bind ,
                     46: the file name
                     47: .I old
                     48: is an alias for the object originally named by
                     49: .IR new ;
                     50: if the modification doesn't hide it,
                     51: .I new
                     52: will also still refer to its original file.
                     53: The evaluation of
                     54: .I new
                     55: (see
                     56: .IR intro (2))
                     57: happens at the time of the
                     58: .IR bind ,
                     59: not when the binding is later used.
                     60: .PP
                     61: The
                     62: .I servename
                     63: argument to
                     64: .I mount
                     65: is the name of a file that, when opened, yields an
                     66: existing connection to a file server.
                     67: Almost always,
                     68: .I servename
                     69: will be a file in
                     70: .B /srv
                     71: (see
                     72: .IR srv (3)).
                     73: In the discussion below,
                     74: .I new
                     75: refers to the file named by the
                     76: .I new
                     77: argument to
                     78: .I bind
                     79: or the root directory of the service
                     80: available in
                     81: .I servename
                     82: after a
                     83: .I mount.
                     84: Either both
                     85: .I old
                     86: and
                     87: .I new
                     88: files must be directories,
                     89: or both must not be directories.
                     90: .PP
                     91: Options control aspects of the modification to the name space:
                     92: .TP 10
                     93: (none)
                     94: Replace the
                     95: .I old
                     96: file by the new one.
                     97: Henceforth, an evaluation of
                     98: .I old
                     99: will be translated to the new file.
                    100: If they are directories (for
                    101: .IR mount ,
                    102: this condition is true by definition),
                    103: .I old
                    104: becomes a
                    105: .I "union directory"
                    106: consisting of one directory (the new file).
                    107: .TP
                    108: .B -b
                    109: Both files must be directories.
                    110: Add the new directory to the beginning
                    111: of the union directory represented by the old file.
                    112: .TP
                    113: .B -a
                    114: Both files must be directories.
                    115: Add the new directory to the end
                    116: of the union directory represented by the old file.
                    117: .TP
                    118: .B -c
                    119: This can be used in addition to any of the above to permit
                    120: creation in a union directory.
                    121: When a new file is created in a union directory,
                    122: it is placed in the first element of the union that permits creation.
                    123: .PD
                    124: .PP
                    125: The
                    126: .I spec
                    127: argument to
                    128: .I mount
                    129: is passed in the
                    130: .IR attach (5)
                    131: message to the server, and selects among different
                    132: file trees served by the server.
                    133: .PP
                    134: The
                    135: .IR srv (3)
                    136: service registry device, normally bound to
                    137: .BR /srv ,
                    138: is a convenient rendezvous point for services that can be mounted.
                    139: After bootstrap, the file
                    140: .B /srv/boot
                    141: contains the communications port to the file system from which
                    142: the system was loaded.
                    143: .PP
                    144: The effects of
                    145: .I bind
                    146: and
                    147: .I mount
                    148: can be undone with the
                    149: .I unmount
                    150: command.
                    151: If two arguments are given to
                    152: .IR unmount ,
                    153: the effect is to undo a
                    154: .I bind
                    155: or
                    156: .I mount
                    157: with the same arguments.
                    158: If only one argument is given,
                    159: everything bound to or mounted upon
                    160: .I old
                    161: is unmounted.
                    162: .SH EXAMPLES
                    163: To compile a program with the C library from July 16, 1992:
                    164: .IP
                    165: .EX
                    166: mount /srv/boot /n/dump dump
                    167: bind /n/dump/1992/0716/mips/lib/libc.a /mips/lib/libc.a
                    168: mk
                    169: .EE
                    170: .SH SOURCE
                    171: .B /sys/src/cmd/bind.c
                    172: .br
                    173: .B /sys/src/cmd/mount.c
                    174: .br
                    175: .B /sys/src/cmd/unmount.c
                    176: .SH SEE ALSO
                    177: .IR bind (2),
                    178: .IR open (2),
                    179: .IR srv (3),
                    180: .IR srv (4)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.