DataMuseum.dk

top - download

    Length: 15368 (0x3c08)
    Names: »lock.4«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat4/lock.4« 

Default Hex Dump

0x0000…0020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x0020…0040 08 75 5f 08 61 5f 08 6c 09 20 20 20 20 20 44 65 76 69 63 65 73 20 61 6e 64 20 46 61 63 69 6c 69   ┆ u_ a_ l      Devices and Facili┆
0x0040…0060 74 69 65 73 09 09 20 20 6c 6f 63 6b 28 34 29 0a 0a 0a 0a 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08   ┆ties    lock(4)    N N N NA A A ┆
0x0060…0080 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20 20 20 6c 6f 63 6b 20 2d 20 68 69 65 72   ┆AM M M ME E E E      lock - hier┆
0x0080…00a0 61 72 63 68 69 63 61 6c 20 6c 6f 63 6b 20 6d 61 6e 61 67 65 6d 65 6e 74 0a 0a 44 08 44 08 44 08   ┆archical lock management  D D D ┆
0x00a0…00c0 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49 08 49   ┆DE E E ES S S SC C C CR R R RI I┆
0x00c0…00e0 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f   ┆ I IP P P PT T T TI I I IO O O O┆
0x00e0…0100 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 54 58 20 6c 6f 63 6b 20 6d 61 6e 61 67 65 72   ┆N N N N      The TX lock manager┆
0x0100…0120 20 73 75 70 70 6f 72 74 73 20 74 77 6f 2d 6c 65 76 65 6c 20 68 69 65 72 61 72 63 68 69 63 61 6c   ┆ supports two-level hierarchical┆
0x0120…0140 20 6c 6f 63 6b 69 6e 67 3a 0a 20 20 20 20 20 61 74 09 74 68 65 20 66 69 6c 65 20 6c 65 76 65 6c   ┆ locking:      at the file level┆
0x0140…0160 20 61 6e 64 20 61 74 20 74 68 65 20 62 6c 6f 63 6b 09 6c 65 76 65 6c 2e 09 45 61 63 68 20 66 69   ┆ and at the block level. Each fi┆
0x0160…0180 6c 65 20 68 61 73 20 61 0a 20 20 20 20 20 73 65 74 20 6f 66 20 62 6c 6f 63 6b 73 20 61 73 20 69   ┆le has a      set of blocks as i┆
0x0180…01a0 74 73 20 69 6d 6d 65 64 69 61 74 65 20 64 65 73 63 65 6e 64 61 6e 74 73 2e 20 20 45 61 63 68 20   ┆ts immediate descendants.  Each ┆
0x01a0…01c0 62 6c 6f 63 6b 20 68 61 73 0a 20 20 20 20 20 61 20 75 6e 69 71 75 65 20 66 69 6c 65 20 61 73 20   ┆block has      a unique file as ┆
0x01c0…01e0 70 61 72 65 6e 74 2e 20 20 54 68 65 20 6c 6f 63 6b 09 6d 61 6e 61 67 65 72 09 63 61 6e 20 62 65   ┆parent.  The lock manager can be┆
0x01e0…0200 20 69 6e 76 6f 6b 65 64 0a 20 20 20 20 20 69 6e 64 69 72 65 63 74 6c 79 09 62 79 20 74 68 65 20   ┆ invoked      indirectly by the ┆
0x0200…0220 5f 08 6f 5f 08 70 5f 08 65 5f 08 6e 20 61 6e 64 09 5f 08 66 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b   ┆_ o_ p_ e_ n and _ f_ l_ o_ c_ k┆
0x0220…0240 20 73 79 73 74 65 6d 20 63 61 6c 6c 73 3b 20 73 65 65 09 74 68 65 20 73 79 73 2d 0a 20 20 20 20   ┆ system calls; see the sys-     ┆
0x0240…0260 20 74 65 6d 20 63 61 6c 6c 73 20 69 6e 20 74 68 69 73 20 6d 61 6e 75 61 6c 2e 0a 0a 20 20 20 20   ┆ tem calls in this manual.      ┆
0x0260…0280 20 54 08 54 08 54 08 54 79 08 79 08 79 08 79 70 08 70 08 70 08 70 65 08 65 08 65 08 65 73 08 73   ┆ T T T Ty y y yp p p pe e e es s┆
0x0280…02a0 08 73 08 73 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08 66 20 41 08 41 08 41 08 41 63 08 63 08 63   ┆ s s o o o of f f f A A A Ac c c┆
0x02a0…02c0 08 63 63 08 63 08 63 08 63 65 08 65 08 65 08 65 73 08 73 08 73 08 73 73 08 73 08 73 08 73 0a 20   ┆ cc c c ce e e es s s ss s s s  ┆
0x02c0…02e0 20 20 20 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 73 20 64 65 73 63 72 69 62 65 64 20 62 65 6c   ┆    The interfaces described bel┆
0x02e0…0300 6f 77 20 61 72 65 09 73 70 65 63 69 66 69 63 20 74 6f 20 74 68 65 09 54 58 0a 20 20 20 20 20 6f   ┆ow are specific to the TX      o┆
0x0300…0320 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 3b 20 74 68 65 72 65 20 69 73 09 73 6f 6d 65 20 6c   ┆perating system; there is some l┆
0x0320…0340 65 76 65 6c 20 6f 66 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 0a 20 20 20 20 20   ┆evel of compatibility with      ┆
0x0340…0360 34 2e 32 42 53 44 20 61 6e 64 09 77 69 74 68 20 55 4e 49 58 20 53 79 73 74 65 6d 20 56 2e 0a 0a   ┆4.2BSD and with UNIX System V.  ┆
0x0360…0380 20 20 20 20 20 41 63 63 65 73 73 20 74 6f 20 61 20 72 65 73 6f 75 72 63 65 20 28 61 20 66 69 6c   ┆     Access to a resource (a fil┆
0x0380…03a0 65 20 6f 72 20 61 20 73 69 6e 67 6c 65 20 62 6c 6f 63 6b 20 6f 66 20 61 20 66 69 6c 65 29 0a 20   ┆e or a single block of a file)  ┆
0x03a0…03c0 20 20 20 20 6d 61 79 20 62 65 20 65 69 74 68 65 72 20 5f 08 65 5f 08 78 5f 08 63 5f 08 6c 5f 08   ┆    may be either _ e_ x_ c_ l_ ┆
0x03c0…03e0 75 5f 08 73 5f 08 69 5f 08 76 5f 08 65 20 28 58 29 20 6f 72 20 5f 08 73 5f 08 68 5f 08 61 5f 08   ┆u_ s_ i_ v_ e (X) or _ s_ h_ a_ ┆
0x03e0…0400 72 5f 08 65 5f 08 64 20 28 53 29 2e 09 20 45 78 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 0a 20   ┆r_ e_ d (S).  Exclusive access  ┆
0x0400…0420 20 20 20 20 70 72 6f 68 69 62 69 74 73 20 5f 08 61 5f 08 6c 5f 08 6c 20 6f 74 68 65 72 20 61 63   ┆    prohibits _ a_ l_ l other ac┆
0x0420…0440 63 65 73 73 09 74 6f 20 74 68 65 20 72 65 73 6f 75 72 63 65 3b 20 73 68 61 72 65 64 09 61 63 63   ┆cess to the resource; shared acc┆
0x0440…0460 65 73 73 0a 20 20 20 20 20 70 65 72 6d 69 74 73 20 6f 74 68 65 72 20 73 68 61 72 65 64 20 61 63   ┆ess      permits other shared ac┆
0x0460…0480 63 65 73 73 20 74 6f 20 74 68 65 09 72 65 73 6f 75 72 63 65 20 61 6e 64 20 70 72 6f 68 69 62 69   ┆cess to the resource and prohibi┆
0x0480…04a0 74 73 0a 20 20 20 20 20 61 6e 79 6f 6e 65 20 66 72 6f 6d 20 6f 62 74 61 69 6e 69 6e 67 20 65 78   ┆ts      anyone from obtaining ex┆
0x04a0…04c0 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 72 65 73 6f 75 72 63 65 2e 0a   ┆clusive access to the resource. ┆
0x04c0…04e0 20 20 20 20 20 45 78 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 20 69 73 20 67 65 6e 65 72 61 6c   ┆     Exclusive access is general┆
0x04e0…0500 6c 79 20 75 73 65 64 09 66 6f 72 20 77 72 69 74 69 6e 67 2c 20 61 6e 64 20 73 68 61 72 65 64 0a   ┆ly used for writing, and shared ┆
0x0500…0520 20 20 20 20 20 61 63 63 65 73 73 20 66 6f 72 09 72 65 61 64 69 6e 67 2e 0a 0a 20 20 20 20 20 55   ┆     access for reading.       U┆
0x0520…0540 73 65 72 20 70 72 6f 67 72 61 6d 73 20 6d 61 79 20 72 65 71 75 65 73 74 20 65 69 74 68 65 72 20   ┆ser programs may request either ┆
0x0540…0560 73 68 61 72 65 64 20 6f 72 09 65 78 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 0a 20 20 20 20 20   ┆shared or exclusive access      ┆
0x0560…0580 74 6f 09 61 6e 20 65 6e 74 69 72 65 20 66 69 6c 65 20 75 73 69 6e 67 20 74 68 65 20 5f 08 66 5f   ┆to an entire file using the _ f_┆
0x0580…05a0 08 6c 5f 08 6f 5f 08 63 5f 08 6b 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 6f 72 20 77 69 74 68 20   ┆ l_ o_ c_ k system call or with ┆
0x05a0…05c0 74 68 65 0a 20 20 20 20 20 4f 5f 53 48 4c 4f 43 4b 20 6f 72 20 4f 5f 45 58 4c 4f 43 4b 20 6f 70   ┆the      O_SHLOCK or O_EXLOCK op┆
0x05c0…05e0 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 5f 08 6f 5f 08 70 5f 08 65 5f 08 6e 20 73 79 73 74 65 6d   ┆tions to the _ o_ p_ e_ n system┆
0x05e0…0600 20 63 61 6c 6c 2e 20 20 54 68 65 0a 20 20 20 20 20 34 2e 32 42 53 44 20 72 65 6c 65 61 73 65 20   ┆ call.  The      4.2BSD release ┆
0x0600…0620 6f 66 20 55 4e 49 58 20 75 73 65 73 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 4c 4f 43 4b 5f   ┆of UNIX uses the arguments LOCK_┆
0x0620…0640 53 48 20 61 6e 64 0a 20 20 20 20 20 4c 4f 43 4b 5f 45 58 20 74 6f 09 5f 08 66 5f 08 6c 5f 08 6f   ┆SH and      LOCK_EX to _ f_ l_ o┆
0x0640…0660 5f 08 63 5f 08 6b 20 74 6f 20 72 65 71 75 65 73 74 20 73 68 61 72 65 64 09 61 6e 64 20 65 78 63   ┆_ c_ k to request shared and exc┆
0x0660…0680 6c 75 73 69 76 65 20 66 69 6c 65 20 6c 6f 63 6b 2d 0a 20 20 20 20 20 69 6e 67 2c 20 72 65 73 70   ┆lusive file lock-      ing, resp┆
0x0680…06a0 65 63 74 69 76 65 6c 79 2e 09 20 50 72 6f 67 72 61 6d 73 20 77 68 69 63 68 09 64 6f 20 6e 6f 74   ┆ectively.  Programs which do not┆
0x06a0…06c0 20 75 73 65 20 74 68 65 20 5f 08 66 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 20 63 61 6c 6c 0a 20 20   ┆ use the _ f_ l_ o_ c_ k call   ┆
0x06c0…06e0 20 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 72 65 20 67 72 61 6e 74 65 64 20 5f 08 69   ┆   automatically are granted _ i┆
0x06e0…0700 5f 08 6e 5f 08 74 5f 08 65 5f 08 6e 5f 08 74 20 6c 6f 63 6b 73 20 74 6f 20 74 68 65 20 66 69 6c   ┆_ n_ t_ e_ n_ t locks to the fil┆
0x0700…0720 65 09 77 68 65 6e 20 74 68 65 0a 20 20 20 20 20 5f 08 6f 5f 08 70 5f 08 65 5f 08 6e 20 73 79 73   ┆e when the      _ o_ p_ e_ n sys┆
0x0720…0740 74 65 6d 20 63 61 6c 6c 20 69 73 20 69 73 73 75 65 64 3a 20 20 61 6e 20 5f 08 69 5f 08 6e 5f 08   ┆tem call is issued:  an _ i_ n_ ┆
0x0740…0760 74 5f 08 65 5f 08 6e 5f 08 74 20 5f 08 73 5f 08 68 5f 08 61 5f 08 72 5f 08 65 5f 08 64 20 28 49   ┆t_ e_ n_ t _ s_ h_ a_ r_ e_ d (I┆
0x0760…0780 53 29 09 6c 6f 63 6b 20 69 73 0a 20 20 20 20 20 6f 62 74 61 69 6e 65 64 20 77 68 65 6e 20 72 65   ┆S) lock is      obtained when re┆
0x0780…07a0 61 64 2d 6f 6e 6c 79 20 61 63 63 65 73 73 20 69 73 20 72 65 71 75 69 72 65 64 2c 20 61 6e 64 20   ┆ad-only access is required, and ┆
0x07a0…07c0 61 6e 09 5f 08 69 5f 08 6e 5f 08 74 5f 08 65 5f 08 6e 5f 08 74 0a 20 20 20 20 20 5f 08 65 5f 08   ┆an _ i_ n_ t_ e_ n_ t      _ e_ ┆
0x07c0…07e0 78 5f 08 63 5f 08 6c 5f 08 75 5f 08 73 5f 08 69 5f 08 76 5f 08 65 20 28 49 58 29 20 6c 6f 63 6b   ┆x_ c_ l_ u_ s_ i_ v_ e (IX) lock┆
0x07e0…0800 20 69 73 20 6f 62 74 61 69 6e 65 64 20 77 68 65 6e 20 61 6e 79 20 66 6f 72 6d 20 6f 66 20 77 72   ┆ is obtained when any form of wr┆
0x0800…0820 69 74 65 0a 20 20 20 20 20 61 63 63 65 73 73 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 0a 20 20   ┆ite      access is required.    ┆
0x0820…0840 20 20 20 5f 08 55 5f 08 70 5f 08 67 5f 08 72 5f 08 61 5f 08 64 5f 08 65 5f 08 73 20 6f 66 20 66   ┆   _ U_ p_ g_ r_ a_ d_ e_ s of f┆
0x0840…0860 69 6c 65 20 6c 6f 63 6b 73 20 61 72 65 09 70 6f 73 73 69 62 6c 65 3a 20 20 61 20 70 72 6f 67 72   ┆ile locks are possible:  a progr┆
0x0860…0880 61 6d 20 6d 61 79 20 6f 70 65 6e 20 74 68 65 0a 20 20 20 20 20 66 69 6c 65 20 69 6e 69 74 69 61   ┆am may open the      file initia┆
0x0880…08a0 6c 6c 79 20 61 6e 64 09 6f 62 74 61 69 6e 20 65 69 74 68 65 72 20 74 79 70 65 20 6f 66 20 69 6e   ┆lly and obtain either type of in┆
0x08a0…08c0 74 65 6e 74 20 6c 6f 63 6b 2c 20 61 6e 64 0a 20 20 20 20 20 74 68 65 6e 20 69 73 73 75 65 09 74   ┆tent lock, and      then issue t┆
0x08c0…08e0 68 65 20 5f 08 66 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 74   ┆he _ f_ l_ o_ c_ k system call t┆
0x08e0…0900 6f 20 69 6e 63 72 65 61 73 65 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 0a 20 20 20 20 20 74 68 65   ┆o increase the level of      the┆
0x0900…0920 20 66 69 6c 65 20 6c 6f 63 6b 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 20 75   ┆ file lock.  For example, if a u┆
0x0920…0940 73 65 72 20 70 72 6f 67 72 61 6d 20 77 68 69 63 68 20 61 6c 72 65 61 64 79 0a 20 20 20 20 20 68   ┆ser program which already      h┆
0x0940…0960 61 64 20 61 20 66 69 6c 65 09 6f 70 65 6e 20 69 6e 76 6f 6b 65 64 20 5f 08 66 5f 08 6c 5f 08 6f   ┆ad a file open invoked _ f_ l_ o┆
0x0960…0980 5f 08 63 5f 08 6b 20 74 6f 20 6f 62 74 61 69 6e 20 5f 08 73 5f 08 68 5f 08 61 5f 08 72 5f 08 65   ┆_ c_ k to obtain _ s_ h_ a_ r_ e┆
0x0980…09a0 5f 08 64 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 0a 20 20 20 20 20 66 69 6c 65 2c 20 74 68 75   ┆_ d access to the      file, thu┆
0x09a0…09c0 73 09 64 69 73 61 6c 6c 6f 77 69 6e 67 20 61 6e 79 09 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65   ┆s disallowing any other processe┆
0x09c0…09e0 73 09 66 72 6f 6d 20 75 70 64 61 74 69 6e 67 20 74 68 65 0a 20 20 20 20 20 66 69 6c 65 2c 20 74   ┆s from updating the      file, t┆
0x09e0…0a00 68 65 20 6c 6f 63 6b 20 75 70 67 72 61 64 65 20 77 6f 75 6c 64 20 6f 63 63 75 72 09 61 73 20 66   ┆he lock upgrade would occur as f┆
0x0a00…0a20 6f 6c 6c 6f 77 73 3a 20 61 6e 20 5f 08 69 5f 08 6e 5f 08 74 5f 08 65 5f 08 6e 5f 08 74 0a 20 20   ┆ollows: an _ i_ n_ t_ e_ n_ t   ┆
0x0a20…0a40 20 20 20 5f 08 73 5f 08 68 5f 08 61 5f 08 72 5f 08 65 5f 08 64 20 28 49 53 29 20 6c 6f 63 6b 20   ┆   _ s_ h_ a_ r_ e_ d (IS) lock ┆
0x0a40…0a60 28 72 65 61 64 2d 6f 6e 6c 79 20 61 63 63 65 73 73 29 20 77 6f 75 6c 64 20 62 65 20 75 70 67 72   ┆(read-only access) would be upgr┆
0x0a60…0a80 61 64 65 64 20 74 6f 20 61 0a 20 20 20 20 20 5f 08 73 5f 08 68 5f 08 61 5f 08 72 5f 08 65 5f 08   ┆aded to a      _ s_ h_ a_ r_ e_ ┆
0x0a80…0aa0 64 20 28 53 29 09 6c 6f 63 6b 2c 20 61 6e 64 20 61 6e 20 5f 08 69 5f 08 6e 5f 08 74 5f 08 65 5f   ┆d (S) lock, and an _ i_ n_ t_ e_┆
0x0aa0…0ac0 08 6e 5f 08 74 20 5f 08 65 5f 08 78 5f 08 63 5f 08 6c 5f 08 75 5f 08 73 5f 08 69 5f 08 76 5f 08   ┆ n_ t _ e_ x_ c_ l_ u_ s_ i_ v_ ┆
0x0ac0…0ae0 65 20 28 49 58 29 20 6c 6f 63 6b 09 28 72 65 61 64 2d 0a 20 20 20 20 20 77 72 69 74 65 20 61 63   ┆e (IX) lock (read-      write ac┆
0x0ae0…0b00 63 65 73 73 29 20 77 6f 75 6c 64 20 62 65 20 75 70 67 72 61 64 65 64 20 74 6f 09 74 68 65 20 73   ┆cess) would be upgraded to the s┆
0x0b00…0b20 70 65 63 69 61 6c 20 6c 6f 63 6b 20 74 79 70 65 0a 20 20 20 20 20 5f 08 73 5f 08 68 5f 08 61 5f   ┆pecial lock type      _ s_ h_ a_┆
0x0b20…0b40 08 72 5f 08 65 5f 08 64 2d 5f 08 61 5f 08 6e 5f 08 64 2d 5f 08 69 5f 08 6e 5f 08 74 5f 08 65 5f   ┆ r_ e_ d-_ a_ n_ d-_ i_ n_ t_ e_┆
0x0b40…0b60 08 6e 5f 08 74 20 5f 08 65 5f 08 78 5f 08 63 5f 08 6c 5f 08 75 5f 08 73 5f 08 69 5f 08 76 5f 08   ┆ n_ t _ e_ x_ c_ l_ u_ s_ i_ v_ ┆
0x0b60…0b80 65 20 28 53 49 58 29 2e 0a 0a 20 20 20 20 20 57 68 65 6e 65 76 65 72 20 61 09 70 72 6f 67 72 61   ┆e (SIX).       Whenever a progra┆
0x0b80…0ba0 6d 09 72 65 71 75 65 73 74 73 20 61 20 6c 6f 63 6b 09 6f 72 20 61 6e 20 75 70 67 72 61 64 65 2c   ┆m requests a lock or an upgrade,┆
0x0ba0…0bc0 20 6f 6e 65 20 6f 66 0a 20 20 20 20 20 66 6f 75 72 20 72 65 73 75 6c 74 73 20 6f 63 63 75 72 73   ┆ one of      four results occurs┆
0x0bc0…0be0 3a 0a 0a 20 20 20 20 20 31 2e 09 20 20 20 54 68 65 20 72 65 73 6f 75 72 63 65 09 69 73 20 61 76   ┆:       1.    The resource is av┆
0x0be0…0c00 61 69 6c 61 62 6c 65 2c 20 61 6e 64 20 74 68 65 20 75 70 67 72 61 64 65 20 69 73 20 70 65 72 2d   ┆ailable, and the upgrade is per-┆
0x0c00…0c20 0a 09 20 20 20 66 6f 72 6d 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 09 5f 08 66 5f 08 6c 5f   ┆     formed immediately. _ f_ l_┆
0x0c20…0c40 08 6f 5f 08 63 5f 08 6b 20 72 65 74 75 72 6e 73 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 74 6f 20   ┆ o_ c_ k returns immediately to ┆
0x0c40…0c60 74 68 65 0a 09 20 20 20 75 73 65 72 3b 20 74 68 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 28 5f   ┆the     user; the system call (_┆
0x0c60…0c80 08 6f 5f 08 70 5f 08 65 5f 08 6e 2c 09 5f 08 72 5f 08 65 5f 08 61 5f 08 64 2c 20 6f 72 20 5f 08   ┆ o_ p_ e_ n, _ r_ e_ a_ d, or _ ┆
0x0c80…0ca0 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 29 09 63 6f 6d 70 6c 65 74 65 73 0a 09 20 20 20 61 6e 64   ┆w_ r_ i_ t_ e) completes     and┆
0x0ca0…0cc0 20 72 65 74 75 72 6e 73 20 74 6f 20 74 68 65 20 75 73 65 72 2e 0a 0a 20 20 20 20 20 32 2e 09 20   ┆ returns to the user.       2.  ┆
0x0cc0…0ce0 20 20 54 68 65 20 72 65 73 6f 75 72 63 65 09 69 73 20 69 6e 20 75 73 65 20 62 79 20 6f 6e 65 20   ┆  The resource is in use by one ┆
0x0ce0…0d00 6f 72 20 6d 6f 72 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 0a 09 20 20 20 28 73 65 65   ┆or more other processes     (see┆
0x0d00…0d20 09 4c 08 4c 08 4c 08 4c 6f 08 6f 08 6f 08 6f 63 08 63 08 63 08 63 6b 08 6b 08 6b 08 6b 20 43 08   ┆ L L L Lo o o oc c c ck k k k C ┆
0x0d20…0d40 43 08 43 08 43 6f 08 6f 08 6f 08 6f 6d 08 6d 08 6d 08 6d 70 08 70 08 70 08 70 61 08 61 08 61 08   ┆C C Co o o om m m mp p p pa a a ┆
0x0d40…0d60 61 74 08 74 08 74 08 74 69 08 69 08 69 08 69 62 08 62 08 62 08 62 69 08 69 08 69 08 69 6c 08 6c   ┆at t t ti i i ib b b bi i i il l┆
0x0d60…0d80 08 6c 08 6c 69 08 69 08 69 08 69 74 08 74 08 74 08 74 79 08 79 08 79 08 79 20 62 65 6c 6f 77 29   ┆ l li i i it t t ty y y y below)┆
0x0d80…0da0 2e 20 20 49 66 20 74 68 65 20 75 73 65 72 09 72 65 71 75 65 73 74 65 64 0a 09 20 20 20 5f 08 6e   ┆.  If the user requested     _ n┆
0x0da0…0dc0 5f 08 6f 5f 08 6e 2d 5f 08 62 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 5f 08 69 5f 08 6e 5f 08 67 09   ┆_ o_ n-_ b_ l_ o_ c_ k_ i_ n_ g ┆
0x0dc0…0de0 61 63 74 69 6f 6e 2c 09 74 68 65 20 70 72 6f 63 65 73 73 20 72 65 63 65 69 76 65 73 20 61 6e 09   ┆action, the process receives an ┆
0x0de0…0e00 69 6d 6d 65 64 69 61 74 65 0a 0a 0a 0a 0a 0a 0a 09 20 20 20 65 72 72 6f 72 20 72 65 74 75 72 6e   ┆immediate           error return┆
0x0e00…0e20 09 28 45 41 47 41 49 4e 29 2e 0a 0a 20 20 20 20 20 33 2e 09 20 20 20 54 68 65 20 72 65 73 6f 75   ┆ (EAGAIN).       3.    The resou┆
0x0e20…0e40 72 63 65 09 69 73 20 69 6e 20 75 73 65 20 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 74 68   ┆rce is in use by one or more oth┆
0x0e40…0e60 65 72 20 70 72 6f 63 65 73 73 65 73 0a 09 20 20 20 61 6e 64 20 74 68 65 20 75 73 65 72 09 64 69   ┆er processes     and the user di┆
0x0e60…0e80 64 20 5f 08 6e 5f 08 6f 5f 08 74 09 72 65 71 75 65 73 74 09 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67   ┆d _ n_ o_ t request non-blocking┆
0x0e80…0ea0 20 61 63 74 69 6f 6e 2e 20 20 54 68 65 0a 09 20 20 20 6c 6f 63 6b 2d 6d 61 6e 61 67 65 6d 65 6e   ┆ action.  The     lock-managemen┆
0x0ea0…0ec0 74 20 73 79 73 74 65 6d 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 72 20 74 68 65 20   ┆t system determines whether the ┆
0x0ec0…0ee0 70 72 6f 63 65 73 73 0a 09 20 20 20 63 61 6e 20 62 65 20 73 61 66 65 6c 79 20 62 6c 6f 63 6b 65   ┆process     can be safely blocke┆
0x0ee0…0f00 64 2e 20 20 49 66 20 73 6f 2c 20 74 68 65 20 70 72 6f 63 65 73 73 20 69 73 20 62 6c 6f 63 6b 65   ┆d.  If so, the process is blocke┆
0x0f00…0f20 64 0a 09 20 20 20 75 6e 74 69 6c 20 74 68 65 20 72 65 73 6f 75 72 63 65 20 69 73 20 61 76 61 69   ┆d     until the resource is avai┆
0x0f20…0f40 6c 61 62 6c 65 2e 0a 0a 20 20 20 20 20 34 2e 09 20 20 20 54 68 65 20 72 65 73 6f 75 72 63 65 09   ┆lable.       4.    The resource ┆
0x0f40…0f60 69 73 20 69 6e 20 75 73 65 20 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 74 68 65 72 20 70   ┆is in use by one or more other p┆
0x0f60…0f80 72 6f 63 65 73 73 65 73 2c 0a 09 20 20 20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 6e 6f 74   ┆rocesses,     the caller did not┆
0x0f80…0fa0 20 72 65 71 75 65 73 74 20 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 20 61 63 74 69 6f 6e 2c 20 61 6e   ┆ request non-blocking action, an┆
0x0fa0…0fc0 64 0a 09 20 20 20 74 68 65 20 73 79 73 74 65 6d 20 64 65 74 65 63 74 73 20 74 68 61 74 20 74 68   ┆d     the system detects that th┆
0x0fc0…0fe0 65 20 5f 08 64 5f 08 65 5f 08 61 5f 08 64 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 09 63 6f 6e 64 69   ┆e _ d_ e_ a_ d_ l_ o_ c_ k condi┆
0x0fe0…1000 74 69 6f 6e 20 77 6f 75 6c 64 0a 09 20 20 20 72 65 73 75 6c 74 20 66 72 6f 6d 20 62 6c 6f 63 6b   ┆tion would     result from block┆
0x1000…1020 69 6e 67 09 74 68 65 20 70 72 6f 63 65 73 73 2e 20 20 49 66 20 74 68 65 20 73 79 73 74 65 6d 20   ┆ing the process.  If the system ┆
0x1020…1040 63 61 6c 6c 0a 09 20 20 20 63 61 75 73 69 6e 67 20 74 68 65 20 64 65 61 64 6c 6f 63 6b 09 73 70   ┆call     causing the deadlock sp┆
0x1040…1060 65 63 69 66 69 65 73 20 49 4f 5f 4e 4f 53 49 47 41 42 4f 52 54 2c 20 74 68 65 0a 09 20 20 20 65   ┆ecifies IO_NOSIGABORT, the     e┆
0x1060…1080 72 72 6f 72 20 45 44 45 41 44 4c 4f 43 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68   ┆rror EDEADLOCK is returned to th┆
0x1080…10a0 65 20 63 61 6c 6c 65 72 2e 20 20 49 66 0a 09 20 20 20 49 4f 5f 4e 4f 53 49 47 41 42 4f 52 54 20   ┆e caller.  If     IO_NOSIGABORT ┆
0x10a0…10c0 69 73 20 6e 6f 74 09 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 20 53 49 47 41 42 4f 52 54 09 73   ┆is not specified, the SIGABORT s┆
0x10c0…10e0 69 67 6e 61 6c 20 69 73 0a 09 20 20 20 64 65 6c 69 76 65 72 65 64 20 74 6f 09 74 68 65 20 70 72   ┆ignal is     delivered to the pr┆
0x10e0…1100 6f 63 65 73 73 20 77 69 74 68 20 74 68 65 20 5f 08 63 5f 08 6f 5f 08 64 5f 08 65 20 76 61 6c 75   ┆ocess with the _ c_ o_ d_ e valu┆
0x1100…1120 65 0a 09 20 20 20 54 52 5f 44 45 41 44 4c 4f 43 4b 2e 09 20 49 66 20 6e 6f 20 73 69 67 6e 61 6c   ┆e     TR_DEADLOCK.  If no signal┆
0x1120…1140 20 68 61 6e 64 6c 65 72 20 69 73 20 70 72 65 73 65 6e 74 2c 20 74 68 65 0a 09 20 20 20 64 65 66   ┆ handler is present, the     def┆
0x1140…1160 61 75 6c 74 20 61 63 74 69 6f 6e 20 69 73 20 74 6f 09 6b 69 6c 6c 20 74 68 65 20 70 72 6f 63 65   ┆ault action is to kill the proce┆
0x1160…1180 73 73 2e 0a 0a 20 20 20 20 20 52 08 52 08 52 08 52 65 08 65 08 65 08 65 6c 08 6c 08 6c 08 6c 65   ┆ss.       R R R Re e e el l l le┆
0x1180…11a0 08 65 08 65 08 65 61 08 61 08 61 08 61 73 08 73 08 73 08 73 69 08 69 08 69 08 69 6e 08 6e 08 6e   ┆ e e ea a a as s s si i i in n n┆
0x11a0…11c0 08 6e 67 08 67 08 67 08 67 20 61 08 61 08 61 08 61 20 4c 08 4c 08 4c 08 4c 6f 08 6f 08 6f 08 6f   ┆ ng g g g a a a a L L L Lo o o o┆
0x11c0…11e0 63 08 63 08 63 08 63 6b 08 6b 08 6b 08 6b 0a 20 20 20 20 20 52 65 67 61 72 64 69 6e 67 20 72 65   ┆c c c ck k k k      Regarding re┆
0x11e0…1200 6c 65 61 73 69 6e 67 20 6c 6f 63 6b 73 2c 09 70 72 6f 63 65 73 73 65 73 20 77 68 69 63 68 09 61   ┆leasing locks, processes which a┆
0x1200…1220 72 65 20 69 6e 20 74 72 61 6e 73 61 63 2d 0a 20 20 20 20 20 74 69 6f 6e 20 73 74 61 74 65 09 62   ┆re in transac-      tion state b┆
0x1220…1240 65 68 61 76 65 20 64 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 09 70 72 6f 63 65 73 73 65 73   ┆ehave differently from processes┆
0x1240…1260 20 74 68 61 74 20 61 72 65 20 6e 6f 74 2e 0a 0a 20 20 20 20 20 4e 6f 6e 2d 74 72 61 6e 73 61 63   ┆ that are not.       Non-transac┆
0x1260…1280 74 69 6f 6e 20 70 72 6f 63 65 73 73 65 73 20 6d 61 79 20 61 63 71 75 69 72 65 20 66 69 6c 65 2d   ┆tion processes may acquire file-┆
0x1280…12a0 6c 65 76 65 6c 20 6c 6f 63 6b 73 2e 0a 20 20 20 20 20 53 75 63 68 20 6c 6f 63 6b 73 09 61 72 65   ┆level locks.      Such locks are┆
0x12a0…12c0 20 72 65 6c 65 61 73 65 64 20 65 69 74 68 65 72 20 77 68 65 6e 20 74 68 65 20 66 69 6c 65 20 69   ┆ released either when the file i┆
0x12c0…12e0 73 20 5f 08 63 5f 08 6c 5f 08 6f 5f 08 73 5f 08 65 64 20 6f 72 0a 20 20 20 20 20 77 68 65 6e 20   ┆s _ c_ l_ o_ s_ ed or      when ┆
0x12e0…1300 74 68 65 20 5f 08 66 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 20 73 79 73 74 65 6d 20 63 61 6c 6c 09   ┆the _ f_ l_ o_ c_ k system call ┆
0x1300…1320 69 73 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 09 74 68 65 20 75 6e 6c 6f 63 6b 0a 20 20 20 20 20   ┆is invoked with the unlock      ┆
0x1320…1340 28 4c 4f 43 4b 5f 55 4e 29 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 45 61 63 68 09 66 69 6c 65 2d   ┆(LOCK_UN) operation.  Each file-┆
0x1340…1360 6c 65 76 65 6c 20 6c 6f 63 6b 09 69 73 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 20 20 20 77 69   ┆level lock is associated      wi┆
0x1360…1380 74 68 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 66 69 6c 65 20 28 61 63 74 75 61 6c 6c 79 20 74   ┆th a particular file (actually t┆
0x1380…13a0 68 65 20 5f 08 69 2d 5f 08 6e 5f 08 6f 5f 08 64 5f 08 65 29 20 61 6e 64 20 61 09 70 72 6f 63 65   ┆he _ i-_ n_ o_ d_ e) and a proce┆
0x13a0…13c0 73 73 2e 0a 20 20 20 20 20 28 41 09 66 69 6c 65 20 69 73 09 6e 6f 74 20 75 73 75 61 6c 6c 79 20   ┆ss.      (A file is not usually ┆
0x13c0…13e0 5f 08 63 5f 08 6c 5f 08 6f 5f 08 73 5f 08 65 64 20 75 6e 6c 65 73 73 20 74 68 69 73 20 69 73 20   ┆_ c_ l_ o_ s_ ed unless this is ┆
0x13e0…1400 74 68 65 20 6c 61 73 74 20 72 65 66 65 72 2d 0a 20 20 20 20 20 65 6e 63 65 20 62 79 20 74 68 65   ┆the last refer-      ence by the┆
0x1400…1420 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 2e 29 0a 0a 20 20 20 20 20 4e 6f 6e 2d 74 72 61   ┆ calling process.)       Non-tra┆
0x1420…1440 6e 73 61 63 74 69 6f 6e 20 70 72 6f 63 65 73 73 65 73 20 63 61 6e 20 61 6c 73 6f 09 61 63 71 75   ┆nsaction processes can also acqu┆
0x1440…1460 69 72 65 09 62 6c 6f 63 6b 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 0a 20 20 20 20 20 77 69 74 68 20   ┆ire block-level locks      with ┆
0x1460…1480 74 68 65 20 5f 08 6d 5f 08 62 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 20 73 79 73 74 65 6d 20 63 61   ┆the _ m_ b_ l_ o_ c_ k system ca┆
0x1480…14a0 6c 6c 2e 20 20 54 68 69 73 09 63 61 6c 6c 20 69 73 09 61 6c 6c 6f 77 65 64 09 6f 6e 6c 79 20 6f   ┆ll.  This call is allowed only o┆
0x14a0…14c0 6e 0a 20 20 20 20 20 75 6e 2d 63 6f 6e 74 72 6f 6c 6c 65 64 20 28 6e 6f 6e 2d 74 72 61 6e 73 61   ┆n      un-controlled (non-transa┆
0x14c0…14e0 63 74 69 6f 6e 2d 6f 72 69 65 6e 74 65 64 29 20 66 69 6c 65 73 2e 0a 0a 20 20 20 20 20 50 72 6f   ┆ction-oriented) files.       Pro┆
0x14e0…1500 67 72 61 6d 73 20 74 68 61 74 20 6f 70 65 72 61 74 65 20 69 6e 20 74 72 61 6e 73 61 63 74 69 6f   ┆grams that operate in transactio┆
0x1500…1520 6e 20 73 74 61 74 65 09 6d 61 79 20 61 63 71 75 69 72 65 20 62 6f 74 68 0a 20 20 20 20 20 66 69   ┆n state may acquire both      fi┆
0x1520…1540 6c 65 2d 6c 65 76 65 6c 09 61 6e 64 20 62 6c 6f 63 6b 2d 6c 65 76 65 6c 09 6c 6f 63 6b 73 2e 09   ┆le-level and block-level locks. ┆
0x1540…1560 46 69 6c 65 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 61 63 71 75 69 72 65 64 0a 20 20 20 20 20 65   ┆File-level locks acquired      e┆
0x1560…1580 69 74 68 65 72 20 5f 08 62 5f 08 65 5f 08 66 5f 08 6f 5f 08 72 5f 08 65 20 74 68 65 20 62 65 67   ┆ither _ b_ e_ f_ o_ r_ e the beg┆
0x1580…15a0 69 6e 6e 69 6e 67 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 28 6f 72 20 69 6e 73 69   ┆inning of a transaction (or insi┆
0x15a0…15c0 64 65 20 61 0a 20 20 20 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 20 61 72 65 20 72 65 74 61 69   ┆de a      transaction) are retai┆
0x15c0…15e0 6e 65 64 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f   ┆ned to the end of the transactio┆
0x15e0…1600 6e 20 65 76 65 6e 0a 20 20 20 20 20 69 66 09 74 68 65 20 70 72 6f 67 72 61 6d 20 72 65 6c 65 61   ┆n even      if the program relea┆
0x1600…1620 73 65 73 20 74 68 65 6d 20 64 75 72 69 6e 67 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e   ┆ses them during the transaction.┆
0x1620…1640 20 20 46 6f 72 0a 20 20 20 20 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 20 70 72 6f 67 72 61 6d   ┆  For      example, if a program┆
0x1640…1660 20 5f 08 6f 5f 08 70 5f 08 65 5f 08 6e 73 20 61 20 66 69 6c 65 09 66 6f 72 20 65 78 63 6c 75 73   ┆ _ o_ p_ e_ ns a file for exclus┆
0x1660…1680 69 76 65 20 61 63 63 65 73 73 2c 0a 20 20 20 20 20 62 65 67 69 6e 73 20 61 20 74 72 61 6e 73 61   ┆ive access,      begins a transa┆
0x1680…16a0 63 74 69 6f 6e 20 76 69 61 20 5f 08 74 5f 08 72 5f 08 61 5f 08 6e 5f 08 73 20 28 54 52 5f 42 45   ┆ction via _ t_ r_ a_ n_ s (TR_BE┆
0x16a0…16c0 47 49 4e 2c 20 30 29 2c 20 61 6e 64 20 74 68 65 6e 2c 0a 20 20 20 20 20 77 68 69 6c 65 20 69 6e   ┆GIN, 0), and then,      while in┆
0x16c0…16e0 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 5f 08 63 5f 08 6c 5f 08 6f 5f 08 73 5f 08   ┆ the transaction, _ c_ l_ o_ s_ ┆
0x16e0…1700 65 73 20 74 68 65 20 66 69 6c 65 2c 09 74 68 65 20 6c 6f 63 6b 20 77 69 6c 6c 20 6e 6f 74 0a 20   ┆es the file, the lock will not  ┆
0x1700…1720 20 20 20 20 62 65 09 72 65 6c 65 61 73 65 64 20 75 6e 74 69 6c 20 74 68 65 20 74 72 61 6e 73 61   ┆    be released until the transa┆
0x1720…1740 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 20 6f 72 20 61 62 6f 72 74 73 2e 0a 0a 20 20 20 20 20 42   ┆ction commits or aborts.       B┆
0x1740…1760 08 42 08 42 08 42 6c 08 6c 08 6c 08 6c 6f 08 6f 08 6f 08 6f 63 08 63 08 63 08 63 6b 08 6b 08 6b   ┆ B B Bl l l lo o o oc c c ck k k┆
0x1760…1780 08 6b 2d 08 2d 08 2d 08 2d 4c 08 4c 08 4c 08 4c 65 08 65 08 65 08 65 76 08 76 08 76 08 76 65 08   ┆ k- - - -L L L Le e e ev v v ve ┆
0x1780…17a0 65 08 65 08 65 6c 08 6c 08 6c 08 6c 20 4c 08 4c 08 4c 08 4c 6f 08 6f 08 6f 08 6f 63 08 63 08 63   ┆e e el l l l L L L Lo o o oc c c┆
0x17a0…17c0 08 63 6b 08 6b 08 6b 08 6b 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 67 08 67 08 67 08 67 0a 20   ┆ ck k k ki i i in n n ng g g g  ┆
0x17c0…17e0 20 20 20 20 57 68 65 6e 20 61 20 70 72 6f 67 72 61 6d 20 69 73 20 75 73 69 6e 67 20 61 20 66 69   ┆    When a program is using a fi┆
0x17e0…1800 6c 65 20 74 68 61 74 20 77 61 73 20 6f 70 65 6e 65 64 20 69 6e 20 5f 08 63 5f 08 6f 5f 08 6e 5f   ┆le that was opened in _ c_ o_ n_┆
0x1800…1820 08 74 5f 08 72 5f 08 6f 5f 08 6c 5f 08 6c 5f 08 65 5f 08 64 0a 20 20 20 20 20 28 74 72 61 6e 73   ┆ t_ r_ o_ l_ l_ e_ d      (trans┆
0x1820…1840 61 63 74 69 6f 6e 29 20 6d 6f 64 65 09 61 6e 64 20 69 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 69   ┆action) mode and in one of the i┆
0x1840…1860 6e 74 65 6e 74 2d 6c 6f 63 6b 69 6e 67 20 6d 6f 64 65 73 2c 0a 20 20 20 20 20 69 6e 64 69 76 69   ┆ntent-locking modes,      indivi┆
0x1860…1880 64 75 61 6c 09 62 6c 6f 63 6b 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 61 72 65 20 61 75 74 6f 6d   ┆dual block-level locks are autom┆
0x1880…18a0 61 74 69 63 61 6c 6c 79 20 73 65 74 09 66 6f 72 20 65 61 63 68 0a 20 20 20 20 20 64 61 74 61 20   ┆atically set for each      data ┆
0x18a0…18c0 70 61 67 65 2e 0a 0a 20 20 20 20 20 42 6c 6f 63 6b 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 6d 61   ┆page.       Block-level locks ma┆
0x18c0…18e0 79 20 62 65 20 73 65 74 20 6f 6e 20 75 6e 2d 63 6f 6e 74 72 6f 6c 6c 65 64 20 66 69 6c 65 73 20   ┆y be set on un-controlled files ┆
0x18e0…1900 75 73 69 6e 67 0a 20 20 20 20 20 74 68 65 20 5f 08 6d 5f 08 62 5f 08 6c 5f 08 6f 5f 08 63 5f 08   ┆using      the _ m_ b_ l_ o_ c_ ┆
0x1900…1920 6b 09 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a 20 20 20 20 20 4f 6e 6c 79 20 74 77 6f 20 66 6f   ┆k system call.       Only two fo┆
[…truncated at 200 lines…]