|
DataMuseum.dkPresents historical artifacts from the history of: RC9000 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about RC9000 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - downloadIndex: r
Length: 14997 (0x3a95)
Names: »read.2«
└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
└─⟦bbf173f5c⟧ »0004«
└─⟦this⟧ »./bsd/usr/man/cat2/read.2«
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 20 20 20 20 20 20 20 20 20 20 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c ┆ u_ a_ l System Call┆ 0x0040…0060 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 61 64 28 32 29 0a 0a 0a 0a ┆s read(2) ┆ 0x0060…0080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20 ┆N N N NA A A AM M M ME E E E ┆ 0x0080…00a0 20 20 72 65 61 64 2c 20 72 65 61 64 76 20 2d 20 72 65 61 64 20 69 6e 70 75 74 0a 0a 53 08 53 08 ┆ read, readv - read input S S ┆ 0x00a0…00c0 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08 41 08 41 08 41 58 ┆S SY Y Y YN N N NT T T TA A A AX┆ 0x00c0…00e0 08 58 08 58 08 58 0a 20 20 20 20 20 63 08 63 08 63 08 63 63 08 63 08 63 08 63 20 3d 08 3d 08 3d ┆ X X X c c c cc c c c = = =┆ 0x00e0…0100 08 3d 20 72 08 72 08 72 08 72 65 08 65 08 65 08 65 61 08 61 08 61 08 61 64 08 64 08 64 08 64 28 ┆ = r r r re e e ea a a ad d d d(┆ 0x0100…0120 08 28 08 28 08 28 66 08 66 08 66 08 66 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 62 08 62 08 ┆ ( ( (f f f fd d d d, , , , b b ┆ 0x0120…0140 62 08 62 75 08 75 08 75 08 75 66 08 66 08 66 08 66 2c 08 2c 08 2c 08 2c 20 6e 08 6e 08 6e 08 6e ┆b bu u u uf f f f, , , , n n n n┆ 0x0140…0160 62 08 62 08 62 08 62 79 08 79 08 79 08 79 74 08 74 08 74 08 74 65 08 65 08 65 08 65 73 08 73 08 ┆b b b by y y yt t t te e e es s ┆ 0x0160…0180 73 08 73 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 ┆s s) ) ) ) i i i in n n nt ┆ 0x0180…01a0 74 08 74 08 74 20 63 08 63 08 63 08 63 63 08 63 08 63 08 63 2c 08 2c 08 2c 08 2c 20 66 08 66 08 ┆t t t c c c cc c c c, , , , f f ┆ 0x01a0…01c0 66 08 66 64 08 64 08 64 08 64 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 ┆f fd d d d; ; ; ; c c c ch ┆ 0x01c0…01e0 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 62 08 62 08 62 ┆h h ha a a ar r r r * * * *b b b┆ 0x01e0…0200 08 62 75 08 75 08 75 08 75 66 08 66 08 66 08 66 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 69 08 69 ┆ bu u u uf f f f; ; ; ; i i┆ 0x0200…0220 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 6e 08 6e 08 6e 08 6e 62 08 62 08 62 08 ┆ i in n n nt t t t n n n nb b b ┆ 0x0220…0240 62 79 08 79 08 79 08 79 74 08 74 08 74 08 74 65 08 65 08 65 08 65 73 08 73 08 73 08 73 3b 08 3b ┆by y y yt t t te e e es s s s; ;┆ 0x0240…0260 08 3b 08 3b 0a 0a 20 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e ┆ ; ; # # # #i i i in n n n┆ 0x0260…0280 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 75 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 ┆c c c cl l l lu u u ud d d de e ┆ 0x0280…02a0 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08 73 08 73 79 08 79 08 79 08 79 73 08 73 08 73 08 73 ┆e e < < < <s s s sy y y ys s s s┆ 0x02a0…02c0 2f 08 2f 08 2f 08 2f 74 08 74 08 74 08 74 79 08 79 08 79 08 79 70 08 70 08 70 08 70 65 08 65 08 ┆/ / / /t t t ty y y yp p p pe e ┆ 0x02c0…02e0 65 08 65 73 08 73 08 73 08 73 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a ┆e es s s s. . . .h h h h> > > > ┆ 0x02e0…0300 20 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 ┆ # # # #i i i in n n nc c c ┆ 0x0300…0320 63 6c 08 6c 08 6c 08 6c 75 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 ┆cl l l lu u u ud d d de e e e < ┆ 0x0320…0340 3c 08 3c 08 3c 73 08 73 08 73 08 73 79 08 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 ┆< < <s s s sy y y ys s s s/ / / ┆ 0x0340…0360 2f 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 65 08 65 08 65 08 65 63 08 63 ┆/i i i io o o ov v v ve e e ec c┆ 0x0360…0380 08 63 08 63 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 20 20 20 20 20 23 ┆ c c. . . .h h h h> > > > #┆ 0x0380…03a0 08 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c ┆ # # #i i i in n n nc c c cl l l┆ 0x03a0…03c0 08 6c 75 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 ┆ lu u u ud d d de e e e < < < <s┆ 0x03c0…03e0 08 73 08 73 08 73 79 08 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 66 08 66 08 66 ┆ s s sy y y ys s s s/ / / /f f f┆ 0x03e0…0400 08 66 69 08 69 08 69 08 69 6c 08 6c 08 6c 08 6c 65 08 65 08 65 08 65 2e 08 2e 08 2e 08 2e 68 08 ┆ fi i i il l l le e e e. . . .h ┆ 0x0400…0420 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 63 08 63 08 63 08 63 63 08 63 08 63 08 ┆h h h> > > > c c c cc c c ┆ 0x0420…0440 63 20 3d 08 3d 08 3d 08 3d 20 72 08 72 08 72 08 72 65 08 65 08 65 08 65 61 08 61 08 61 08 61 64 ┆c = = = = r r r re e e ea a a ad┆ 0x0440…0460 08 64 08 64 08 64 76 08 76 08 76 08 76 28 08 28 08 28 08 28 66 08 66 08 66 08 66 64 08 64 08 64 ┆ d d dv v v v( ( ( (f f f fd d d┆ 0x0460…0480 08 64 2c 08 2c 08 2c 08 2c 20 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 2c ┆ d, , , , i i i io o o ov v v v,┆ 0x0480…04a0 08 2c 08 2c 08 2c 20 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 63 08 63 08 ┆ , , , i i i io o o ov v v vc c ┆ 0x04a0…04c0 63 08 63 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 ┆c cn n n nt t t t) ) ) ) i ┆ 0x04c0…04e0 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 63 08 63 08 63 08 63 63 08 63 08 63 ┆i i in n n nt t t t c c c cc c c┆ 0x04e0…0500 08 63 2c 08 2c 08 2c 08 2c 20 66 08 66 08 66 08 66 64 08 64 08 64 08 64 3b 08 3b 08 3b 08 3b 0a ┆ c, , , , f f f fd d d d; ; ; ; ┆ 0x0500…0520 20 20 20 20 20 73 08 73 08 73 08 73 74 08 74 08 74 08 74 72 08 72 08 72 08 72 75 08 75 08 75 08 ┆ s s s st t t tr r r ru u u ┆ 0x0520…0540 75 63 08 63 08 63 08 63 74 08 74 08 74 08 74 20 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 ┆uc c c ct t t t i i i io o o ov ┆ 0x0540…0560 76 08 76 08 76 65 08 65 08 65 08 65 63 08 63 08 63 08 63 20 2a 08 2a 08 2a 08 2a 69 08 69 08 69 ┆v v ve e e ec c c c * * * *i i i┆ 0x0560…0580 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 69 08 69 ┆ io o o ov v v v; ; ; ; i i┆ 0x0580…05a0 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 ┆ i in n n nt t t t i i i io o o ┆ 0x05a0…05c0 6f 76 08 76 08 76 08 76 63 08 63 08 63 08 63 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 3b 08 3b ┆ov v v vc c c cn n n nt t t t; ;┆ 0x05c0…05e0 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 ┆ ; ; D D D DE E E ES S S SC C C┆ 0x05e0…0600 08 43 52 08 52 08 52 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 ┆ CR R R RI I I IP P P PT T T TI ┆ 0x0600…0620 49 08 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 72 ┆I I IO O O ON N N N The _ r┆ 0x0620…0640 5f 08 65 5f 08 61 5f 08 64 20 61 6e 64 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 5f 08 76 20 63 61 ┆_ e_ a_ d and _ r_ e_ a_ d_ v ca┆ 0x0640…0660 6c 6c 73 20 72 65 61 64 20 61 20 73 70 65 63 69 66 69 65 64 20 61 6d 6f 75 6e 74 20 6f 66 20 64 ┆lls read a specified amount of d┆ 0x0660…0680 61 74 61 0a 20 20 20 20 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 61 20 66 69 6c 65 ┆ata into memory from a file┆ 0x0680…06a0 20 6f 62 6a 65 63 74 20 74 68 61 74 20 69 73 20 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 61 6e ┆ object that is referenced by an┆ 0x06a0…06c0 20 6f 70 65 6e 0a 20 20 20 20 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 0a 0a 20 20 20 ┆ open file descriptor. ┆ 0x06c0…06e0 20 20 63 08 63 08 63 08 63 63 08 63 08 63 08 63 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 ┆ c c c cc c c c Specifies the┆ 0x06e0…0700 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 61 63 74 75 61 6c 6c 79 20 72 65 61 64 2c 20 ┆ number of bytes actually read, ┆ 0x0700…0720 6f 72 20 2d 31 20 69 66 0a 20 20 20 20 20 20 20 20 20 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 ┆or -1 if an error occu┆ 0x0720…0740 72 72 65 64 2e 20 20 49 66 20 5f 08 63 5f 08 63 20 69 73 20 30 2c 20 74 68 65 6e 20 74 68 65 20 ┆rred. If _ c_ c is 0, then the ┆ 0x0740…0760 65 6e 64 2d 6f 66 2d 66 69 6c 65 0a 20 20 20 20 20 20 20 20 20 20 68 61 73 20 62 65 65 6e 20 72 ┆end-of-file has been r┆ 0x0760…0780 65 61 63 68 65 64 2e 0a 0a 20 20 20 20 20 66 08 66 08 66 08 66 64 08 64 08 64 08 64 20 20 20 49 ┆eached. f f f fd d d d I┆ 0x0780…07a0 73 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 6f 66 20 74 68 65 ┆s an open file descriptor of the┆ 0x07a0…07c0 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 66 72 6f 6d 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 63 ┆ file object from whic┆ 0x07c0…07e0 68 20 74 68 65 20 64 61 74 61 20 77 69 6c 6c 20 62 65 20 72 65 61 64 2e 20 20 54 68 65 20 66 6f ┆h the data will be read. The fo┆ 0x07e0…0800 6c 6c 6f 77 69 6e 67 20 66 6c 61 67 20 61 72 67 75 2d 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6e ┆llowing flag argu- men┆ 0x0800…0820 74 73 20 61 72 65 20 5f 08 6f 5f 08 72 65 64 20 28 20 7c 20 29 20 77 69 74 68 20 74 68 65 20 6c ┆ts are _ o_ red ( | ) with the l┆ 0x0820…0840 65 66 74 6d 6f 73 74 20 31 36 20 62 69 74 73 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 ┆eftmost 16 bits of the ┆ 0x0840…0860 20 5f 08 66 5f 08 64 20 61 72 67 75 6d 65 6e 74 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f ┆ _ f_ d argument: IO_┆ 0x0860…0880 4d 42 4c 4f 43 4b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 73 20 6f 6e ┆MBLOCK Applies on┆ 0x0880…08a0 6c 79 20 74 6f 20 64 69 73 6b 20 66 69 6c 65 73 20 74 68 61 74 20 61 72 65 20 5f 08 6e 5f 08 6f ┆ly to disk files that are _ n_ o┆ 0x08a0…08c0 5f 08 74 20 6f 70 65 6e 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 20 74 ┆_ t opened with t┆ 0x08c0…08e0 68 65 20 4f 5f 43 4f 4e 54 52 4f 4c 20 66 6c 61 67 20 73 65 74 2e 20 20 49 66 20 74 68 65 20 66 ┆he O_CONTROL flag set. If the f┆ 0x08e0…0900 6c 61 67 20 69 73 20 73 65 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 5f ┆lag is set, the _┆ 0x0900…0920 08 72 5f 08 65 5f 08 61 5f 08 64 20 63 61 75 73 65 73 20 73 68 61 72 65 64 20 62 6c 6f 63 6b 2d ┆ r_ e_ a_ d causes shared block-┆ 0x0920…0940 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 74 6f 20 62 65 20 73 65 74 0a 20 20 20 20 20 20 20 20 20 20 ┆level locks to be set ┆ 0x0940…0960 20 20 20 20 20 6f 6e 20 74 68 65 20 62 6c 6f 63 6b 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 74 ┆ on the blocks involved in t┆ 0x0960…0980 68 65 20 72 65 61 64 2e 20 28 50 72 6f 63 65 73 73 65 73 20 69 6e 0a 20 20 20 20 20 20 20 20 20 ┆he read. (Processes in ┆ 0x0980…09a0 20 20 20 20 20 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 71 75 69 72 65 20 62 6c 6f 63 ┆ a transaction acquire bloc┆ 0x09a0…09c0 6b 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 61 75 74 6f 6d 61 74 69 2d 0a 20 20 20 20 20 20 20 20 ┆k-level locks automati- ┆ 0x09c0…09e0 20 20 20 20 20 20 20 63 61 6c 6c 79 2e 20 20 41 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 61 63 71 ┆ cally. An attempt to acq┆ 0x09e0…0a00 75 69 72 65 20 74 68 69 73 20 6c 6f 63 6b 20 6f 6e 20 61 20 63 6f 6e 2d 0a 20 20 20 20 20 20 20 ┆uire this lock on a con- ┆ 0x0a00…0a20 20 20 20 20 20 20 20 20 74 72 6f 6c 6c 65 64 20 66 69 6c 65 20 77 6f 75 6c 64 20 62 65 20 69 67 ┆ trolled file would be ig┆ 0x0a20…0a40 6e 6f 72 65 64 2e 29 20 54 68 65 20 49 4f 5f 4d 42 4c 4f 43 4b 20 66 6c 61 67 0a 20 20 20 20 20 ┆nored.) The IO_MBLOCK flag ┆ 0x0a40…0a60 20 20 20 20 20 20 20 20 20 20 69 73 20 6d 61 70 70 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 ┆ is mapped internally t┆ 0x0a60…0a80 6f 20 49 4f 5f 4d 42 4c 4f 43 4b 53 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4d 42 4c 4f ┆o IO_MBLOCKS. IO_MBLO┆ 0x0a80…0aa0 43 4b 48 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 73 20 61 20 60 60 68 ┆CKH Applies a ``h┆ 0x0aa0…0ac0 6f 6c 64 27 27 20 6c 6f 63 6b 20 74 6f 20 65 61 63 68 20 62 6c 6f 63 6b 20 61 63 63 65 73 73 65 ┆old'' lock to each block accesse┆ 0x0ac0…0ae0 64 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 20 64 61 74 61 20 66 69 6c 65 20 ┆d in a data file ┆ 0x0ae0…0b00 62 79 20 74 68 65 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 41 20 68 6f 6c 64 20 6c ┆by the read operation. A hold l┆ 0x0b00…0b20 6f 63 6b 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 74 72 6f 6e 67 65 72 20 74 ┆ock is stronger t┆ 0x0b20…0b40 68 61 6e 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 2c 20 77 65 61 6b 65 72 20 74 68 61 6e 20 61 ┆han a shared lock, weaker than a┆ 0x0b40…0b60 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 2c ┆n exclusive lock,┆ 0x0b60…0b80 20 61 6e 64 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20 69 74 73 65 6c 66 2e 20 54 ┆ and incompatible with itself. T┆ 0x0b80…0ba0 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 20 61 72 67 75 6d 65 6e 74 20 ┆he flag argument ┆ 0x0ba0…0bc0 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d ┆can be used inside transaction m┆ 0x0bc0…0be0 6f 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 61 63 71 75 69 72 65 20 74 68 ┆ode to acquire th┆ 0x0be0…0c00 65 20 73 74 72 6f 6e 67 65 72 20 68 6f 6c 64 20 6c 6f 63 6b 20 72 61 74 68 65 72 20 74 68 61 6e ┆e stronger hold lock rather than┆ 0x0c00…0c20 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 20 73 68 61 72 ┆ the default shar┆ 0x0c20…0c40 65 64 20 6c 6f 63 6b 2c 20 6f 72 20 6f 75 74 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ┆ed lock, or outside transaction ┆ 0x0c40…0c60 6d 6f 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 75 70 67 72 61 64 65 20 6f ┆mode to upgrade o┆ 0x0c60…0c80 72 20 61 63 71 75 69 72 65 20 74 68 65 20 68 6f 6c 64 20 6c 6f 63 6b 2e 20 20 54 68 65 20 73 63 ┆r acquire the hold lock. The sc┆ 0x0c80…0ca0 6f 70 65 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6c 6f 63 6b 20 64 ┆ope of the lock d┆ 0x0ca0…0cc0 65 70 65 6e 64 73 20 6f 6e 20 77 68 65 74 68 65 72 20 74 68 65 20 70 72 6f 63 65 73 73 20 69 73 ┆epends on whether the process is┆ 0x0cc0…0ce0 20 69 6e 73 69 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 72 20 6f 75 74 73 69 64 ┆ inside or outsid┆ 0x0ce0…0d00 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 2e 20 20 49 6e 20 74 72 61 6e 73 63 74 69 ┆e transaction mode. In transcti┆ 0x0d00…0d20 6f 6e 20 6d 6f 64 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6c 6f 63 6b ┆on mode, the lock┆ 0x0d20…0d40 20 69 73 20 68 65 6c 64 20 75 6e 74 69 6c 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 ┆ is held until the transaction c┆ 0x0d40…0d60 6f 6d 6d 69 74 73 20 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 62 6f 72 74 73 2c ┆ommits or aborts,┆ 0x0d60…0d80 20 77 68 65 6e 20 69 74 20 69 73 20 72 65 6d 6f 76 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ┆ when it is removed automaticall┆ 0x0d80…0da0 79 2e 20 20 4f 75 74 73 69 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 ┆y. Outside trans┆ 0x0da0…0dc0 63 74 69 6f 6e 20 6d 6f 64 65 20 74 68 65 20 6c 6f 63 6b 20 6d 75 73 74 20 62 65 20 6d 61 6e 75 ┆ction mode the lock must be manu┆ 0x0dc0…0de0 61 6c 6c 79 20 72 65 6d 6f 76 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 75 73 69 6e ┆ally removed usin┆ 0x0de0…0e00 67 20 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 ┆g the _ m_ b_ l_ o_ c_ k system ┆ 0x0e00…0e20 63 61 6c 6c 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 ┆call. Any attempt to ┆ 0x0e20…0e40 20 20 20 20 20 72 65 6d 6f 76 65 20 74 68 65 20 6c 6f 63 6b 20 6d 61 6e 75 61 6c 6c 79 20 77 69 ┆ remove the lock manually wi┆ 0x0e40…0e60 74 68 69 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 0a 20 20 20 20 20 20 20 20 ┆thin a transaction will ┆ 0x0e60…0e80 20 20 20 20 20 20 20 62 65 20 64 65 66 65 72 72 65 64 20 75 6e 74 69 6c 20 74 68 65 20 74 72 61 ┆ be deferred until the tra┆ 0x0e80…0ea0 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 20 6f 72 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 20 ┆nsaction commits or ┆ 0x0ea0…0ec0 20 20 20 20 20 20 20 20 20 61 62 6f 72 74 73 2e 20 20 54 68 69 73 20 6c 6f 63 6b 20 69 73 20 75 ┆ aborts. This lock is u┆ 0x0ec0…0ee0 73 65 64 20 74 6f 20 64 65 73 69 67 6e 20 70 72 6f 74 6f 63 6f 6c 73 20 74 6f 0a 20 20 20 20 20 ┆sed to design protocols to ┆ 0x0ee0…0f00 20 20 20 20 20 20 20 20 20 20 61 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b 73 20 28 77 69 74 68 20 ┆ avoid deadlocks (with ┆ 0x0f00…0f20 72 65 64 75 63 65 64 20 63 6f 6e 63 75 72 72 65 6e 63 79 29 2e 20 20 53 65 65 0a 20 20 20 20 20 ┆reduced concurrency). See ┆ 0x0f20…0f40 20 20 20 20 20 20 20 20 20 20 74 68 65 20 54 08 54 08 54 08 54 58 08 58 08 58 08 58 20 50 08 50 ┆ the T T T TX X X X P P┆ 0x0f40…0f60 08 50 08 50 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f 67 08 67 08 67 08 67 72 08 72 08 72 08 72 ┆ P Pr r r ro o o og g g gr r r r┆ 0x0f60…0f80 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 72 08 72 08 ┆a a a am m m mm m m me e e er r ┆ 0x0f80…0fa0 72 08 72 27 08 27 08 27 08 27 73 08 73 08 73 08 73 20 47 08 47 08 47 08 47 75 08 75 08 75 08 75 ┆r r' ' ' 's s s s G G G Gu u u u┆ 0x0fa0…0fc0 69 08 69 08 69 08 69 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 66 6f 72 20 64 65 74 61 69 6c ┆i i i id d d de e e e for detail┆ 0x0fc0…0fe0 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4d 42 4c 4f 43 4b 53 0a 20 20 20 20 20 20 20 ┆s. IO_MBLOCKS ┆ 0x0fe0…1000 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 73 20 73 68 61 72 65 64 20 62 6c 6f 63 6b 2d 6c 65 76 ┆ Applies shared block-lev┆ 0x1000…1020 65 6c 20 6c 6f 63 6b 73 20 74 6f 20 65 61 63 68 20 62 6c 6f 63 6b 0a 20 20 20 20 20 20 20 20 20 ┆el locks to each block ┆ 0x1020…1040 20 20 20 20 20 20 61 63 63 65 73 73 65 64 20 69 6e 20 61 20 64 61 74 61 20 66 69 6c 65 20 62 79 ┆ accessed in a data file by┆ 0x1040…1060 20 74 68 65 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 ┆ the read operation. ┆ 0x1060…1080 20 20 20 20 54 68 65 20 6c 6f 63 6b 20 61 70 70 6c 69 65 73 20 6f 6e 6c 79 20 74 6f 20 6e 6f 6e ┆ The lock applies only to non┆ 0x1080…10a0 2d 63 6f 6e 74 72 6f 6c 6c 65 64 20 66 69 6c 65 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆-controlled files. ┆ 0x10a0…10c0 20 20 54 68 65 20 66 6c 61 67 20 69 73 20 69 67 6e 6f 72 65 64 20 69 6e 73 69 64 65 20 74 72 61 ┆ The flag is ignored inside tra┆ 0x10c0…10e0 6e 73 61 63 74 69 6f 6e 73 20 61 73 20 73 68 61 72 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 ┆nsactions as shared ┆ 0x10e0…1100 20 20 20 62 6c 6f 63 6b 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 61 72 65 20 61 63 71 75 69 72 65 ┆ block-level locks are acquire┆ 0x1100…1120 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆d automatically on ┆ 0x1120…1140 20 20 72 65 61 64 69 6e 67 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4d 42 4c 4f 43 4b 58 ┆ reading. IO_MBLOCKX┆ 0x1140…1160 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 73 20 61 6e 20 65 78 63 6c 75 ┆ Applies an exclu┆ 0x1160…1180 73 69 76 65 20 6c 6f 63 6b 20 74 6f 20 65 61 63 68 20 62 6c 6f 63 6b 20 61 63 63 65 73 73 65 64 ┆sive lock to each block accessed┆ 0x1180…11a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 20 61 20 64 61 74 61 20 66 69 6c 65 20 62 ┆ in a data file b┆ 0x11a0…11c0 79 20 74 68 65 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 54 68 65 20 66 6c 61 67 0a ┆y the read operation. The flag ┆ 0x11c0…11e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20 75 ┆ argument can be u┆ 0x11e0…1200 73 65 64 20 69 6e 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 20 74 6f 0a 20 ┆sed inside transaction mode to ┆ 0x1200…1220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 63 71 75 69 72 65 20 74 68 65 20 73 74 72 6f 6e 67 ┆ acquire the strong┆ 0x1220…1240 65 72 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 72 61 74 68 65 72 20 74 68 61 6e 0a 20 20 ┆er exclusive lock rather than ┆ 0x1240…1260 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 68 61 72 65 64 20 ┆ the default shared ┆ 0x1260…1280 6c 6f 63 6b 2c 20 6f 72 20 6f 75 74 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 ┆lock, or outside transaction ┆ 0x1280…12a0 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 65 20 74 6f 20 75 70 67 72 61 64 65 20 6f 72 20 61 ┆ mode to upgrade or a┆ 0x12a0…12c0 63 71 75 69 72 65 20 74 68 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 2e 0a 20 20 20 20 20 ┆cquire the exclusive lock. ┆ 0x12c0…12e0 20 20 20 20 20 20 20 20 20 20 54 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 6c 6f 63 6b 20 ┆ The scope of the lock ┆ 0x12e0…1300 64 65 70 65 6e 64 73 20 6f 6e 20 77 68 65 74 68 65 72 20 74 68 65 20 70 72 6f 2d 0a 20 20 20 20 ┆depends on whether the pro- ┆ 0x1300…1320 20 20 20 20 20 20 20 20 20 20 20 63 65 73 73 20 69 73 20 69 6e 73 69 64 65 20 6f 72 20 6f 75 74 ┆ cess is inside or out┆ 0x1320…1340 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 2e 20 20 49 6e 0a 20 20 20 20 20 ┆side transaction mode. In ┆ 0x1340…1360 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 63 74 69 6f 6e 20 6d 6f 64 65 2c 20 74 68 65 20 6c ┆ transction mode, the l┆ 0x1360…1380 6f 63 6b 20 69 73 20 68 65 6c 64 20 75 6e 74 69 6c 20 74 68 65 20 74 72 61 6e 2d 0a 20 20 20 20 ┆ock is held until the tran- ┆ 0x1380…13a0 20 20 20 20 20 20 20 20 20 20 20 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 20 6f 72 20 61 62 ┆ saction commits or ab┆ 0x13a0…13c0 6f 72 74 73 2c 20 77 68 65 6e 20 69 74 20 69 73 20 72 65 6d 6f 76 65 64 0a 20 20 20 20 20 20 20 ┆orts, when it is removed ┆ 0x13c0…13e0 20 20 20 20 20 20 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 20 20 4f 75 74 73 69 64 65 20 ┆ automatically. Outside ┆ 0x13e0…1400 74 72 61 6e 73 63 74 69 6f 6e 20 6d 6f 64 65 20 74 68 65 20 6c 6f 63 6b 0a 20 20 20 20 20 20 20 ┆transction mode the lock ┆ 0x1400…1420 20 20 20 20 20 20 20 20 6d 75 73 74 20 62 65 20 6d 61 6e 75 61 6c 6c 79 20 72 65 6d 6f 76 65 64 ┆ must be manually removed┆ 0x1420…1440 20 75 73 69 6e 67 20 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 ┆ using the _ m_ b_ l_ o_ c_ k sy┆ 0x1440…1460 73 74 65 6d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6c 6c 2e 20 20 41 6e 79 20 61 ┆stem call. Any a┆ 0x1460…1480 74 74 65 6d 70 74 20 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 6c 6f 63 6b 20 6d 61 6e 75 61 6c ┆ttempt to remove the lock manual┆ 0x1480…14a0 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 69 6e 20 61 20 74 72 61 6e 73 ┆ly within a trans┆ 0x14a0…14c0 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 64 65 66 65 72 72 65 64 20 75 6e 74 69 6c 20 74 68 ┆action will be deferred until th┆ 0x14c0…14e0 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d ┆e transaction com┆ 0x14e0…1500 6d 69 74 73 20 6f 72 20 61 62 6f 72 74 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4e 42 ┆mits or aborts. IO_NB┆ 0x1500…1520 4c 4f 43 4b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 ┆LOCK Specifies th┆ 0x1520…1540 61 74 20 74 68 65 20 72 65 61 64 20 69 73 20 74 6f 20 62 65 20 6e 6f 6e 62 6c 6f 63 6b 69 6e 67 ┆at the read is to be nonblocking┆ 0x1540…1560 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 ┆, regardless of t┆ 0x1560…1580 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 66 6f 72 20 49 2f 4f 20 6f 6e 20 74 68 69 ┆he default action for I/O on thi┆ 0x1580…15a0 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 49 66 ┆s descriptor. If┆ 0x15a0…15c0 20 61 20 62 6c 6f 63 6b 69 6e 67 20 63 6f 6e 64 69 74 69 6f 6e 20 6f 63 63 75 72 73 2c 20 74 68 ┆ a blocking condition occurs, th┆ 0x15c0…15e0 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 61 64 20 66 61 69 6c 73 2e 0a 0a 20 20 ┆e read fails. ┆ 0x15e0…1600 20 20 20 20 20 20 20 20 49 4f 5f 53 49 47 45 52 52 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ IO_SIGERR ┆ 0x1600…1620 20 47 65 6e 65 72 61 74 65 20 53 49 47 45 52 52 20 61 6e 64 20 53 49 47 50 49 50 45 20 73 69 67 ┆ Generate SIGERR and SIGPIPE sig┆ 0x1620…1640 6e 61 6c 73 2e 20 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 20 64 6f 65 73 0a 20 20 20 20 20 20 20 ┆nals. _ r_ e_ a_ d does ┆ 0x1640…1660 20 20 20 20 20 20 20 20 6e 6f 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 61 70 70 72 6f 70 72 69 ┆ not returns the appropri┆ 0x1660…1680 61 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2c 20 62 75 74 20 67 65 6e 2d 0a 20 20 20 20 20 20 20 ┆ate error code, but gen- ┆ 0x1680…16a0 20 20 20 20 20 20 20 20 65 72 61 74 65 73 20 74 68 65 20 73 69 67 6e 61 6c 73 20 69 6e 73 74 65 ┆ erates the signals inste┆ 0x16a0…16c0 61 64 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4e 4f 53 49 47 41 42 4f 52 54 0a 20 20 20 ┆ad. IO_NOSIGABORT ┆ 0x16c0…16e0 20 20 20 20 20 20 20 20 20 20 20 20 44 6f 20 6e 6f 74 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 ┆ Do not generate the ┆ 0x16e0…1700 53 49 47 41 42 4f 52 54 20 73 69 67 6e 61 6c 2e 20 20 54 68 65 20 73 79 73 74 65 6d 0a 20 20 20 ┆SIGABORT signal. The system ┆ 0x1700…1720 20 20 20 20 20 20 20 20 20 20 20 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 74 68 65 20 75 73 65 ┆ assumes that the use┆ 0x1720…1740 72 20 68 61 73 20 73 75 70 70 6c 69 65 64 20 63 6f 64 65 20 61 74 20 74 68 65 0a 20 20 20 20 20 ┆r has supplied code at the ┆ 0x1740…1760 20 20 20 20 20 20 20 20 20 20 70 6f 69 6e 74 20 6f 66 20 74 68 65 20 5f 08 72 5f 08 65 5f 08 61 ┆ point of the _ r_ e_ a┆ 0x1760…1780 5f 08 64 20 74 6f 20 64 65 74 65 63 74 20 61 6e 64 20 68 61 6e 64 6c 65 20 74 72 61 6e 73 61 63 ┆_ d to detect and handle transac┆ 0x1780…17a0 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 62 6f 72 74 73 2e 20 20 49 66 20 ┆tion aborts. If ┆ 0x17a0…17c0 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 62 6f 72 74 20 64 6f 65 73 20 6f 63 63 75 72 2c 20 ┆a transaction abort does occur, ┆ 0x17c0…17e0 5f 08 72 5f 08 65 5f 08 61 5f 08 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 ┆_ r_ e_ a_ d retu┆ 0x17e0…1800 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 61 6e 64 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f ┆rns an error and _ e_ r_ r_ n_ o┆ 0x1800…1820 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 69 6e 64 69 63 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 ┆ contains an indication ┆ 0x1820…1840 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 65 72 72 6f 72 2e 20 20 54 68 65 20 74 72 61 6e 73 61 ┆ of the error. The transa┆ 0x1840…1860 63 74 69 6f 6e 20 61 62 6f 72 74 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20 20 20 20 20 20 20 20 ┆ction abort does not ┆ 0x1860…1880 20 20 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 63 63 75 72 2e 0a 0a 20 20 20 20 20 20 ┆ automatically occur. ┆ 0x1880…18a0 20 20 20 20 49 4f 5f 57 49 4e 54 45 4e 54 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e ┆ IO_WINTENT In┆ 0x18a0…18c0 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65 20 70 72 6f 67 72 61 6d 20 69 6e 74 65 6e 64 73 ┆dicates that the program intends┆ 0x18c0…18e0 20 74 6f 20 77 72 69 74 65 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 61 67 ┆ to write the pag┆ 0x18e0…1900 65 2e 20 20 52 65 71 75 65 73 74 73 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 69 6d 6d 65 ┆e. Requests the write lock imme┆ 0x1900…1920 64 69 61 74 65 6c 79 2e 20 20 54 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6c ┆diately. This fl┆ […truncated at 200 lines…]