|
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: 15774 (0x3d9e)
Names: »readrandom.2«
└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
└─⟦bbf173f5c⟧ »0004«
└─⟦this⟧ »./bsd/usr/man/cat2/readrandom.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 72 65 61 64 72 61 6e 64 6f 6d 28 32 29 0a 0a 0a 0a ┆s readrandom(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 72 61 6e 64 6f 6d 2c 20 72 65 61 64 76 72 61 6e 64 6f 6d 20 2d 20 72 65 61 64 ┆ readrandom, readvrandom - read┆ 0x00a0…00c0 20 66 72 6f 6d 20 67 69 76 65 6e 20 6f 66 66 73 65 74 20 66 72 6f 6d 20 66 69 6c 65 0a 20 20 20 ┆ from given offset from file ┆ 0x00c0…00e0 20 20 73 74 61 72 74 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 ┆ start S S S SY Y Y YN N N NT ┆ 0x00e0…0100 54 08 54 08 54 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 63 08 63 08 63 08 63 ┆T T TA A A AX X X X c c c c┆ 0x0100…0120 63 08 63 08 63 08 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 ┆c c c c = = = = r r r re e e ea ┆ 0x0120…0140 61 08 61 08 61 64 08 64 08 64 08 64 72 08 72 08 72 08 72 61 08 61 08 61 08 61 6e 08 6e 08 6e 08 ┆a a ad d d dr r r ra a a an n n ┆ 0x0140…0160 6e 64 08 64 08 64 08 64 6f 08 6f 08 6f 08 6f 6d 08 6d 08 6d 08 6d 28 08 28 08 28 08 28 66 08 66 ┆nd d d do o o om m m m( ( ( (f f┆ 0x0160…0180 08 66 08 66 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08 ┆ f fd d d d, , , , o o o of f f ┆ 0x0180…01a0 66 66 08 66 08 66 08 66 73 08 73 08 73 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 2c 08 2c ┆ff f f fs s s se e e et t t t, ,┆ 0x01a0…01c0 08 2c 08 2c 20 62 08 62 08 62 08 62 75 08 75 08 75 08 75 66 08 66 08 66 08 66 2c 08 2c 08 2c 08 ┆ , , b b b bu u u uf f f f, , , ┆ 0x01c0…01e0 2c 20 6e 08 6e 08 6e 08 6e 62 08 62 08 62 08 62 79 08 79 08 79 08 79 74 08 74 08 74 08 74 65 08 ┆, n n n nb b b by y y yt t t te ┆ 0x01e0…0200 65 08 65 08 65 73 08 73 08 73 08 73 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08 69 08 69 ┆e e es s s s) ) ) ) i i i i┆ 0x0200…0220 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 08 63 2c 08 2c ┆n n n nt t t t c c c cc c c c, ,┆ 0x0220…0240 08 2c 08 2c 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08 66 66 08 66 08 66 08 66 73 08 73 08 73 08 ┆ , , o o o of f f ff f f fs s s ┆ 0x0240…0260 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 2c 08 2c 08 2c 08 2c 20 66 08 66 08 66 08 66 64 08 ┆se e e et t t t, , , , f f f fd ┆ 0x0260…0280 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 68 08 68 08 68 ┆d d d; ; ; ; c c c ch h h h┆ 0x0280…02a0 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 08 62 75 08 75 ┆a a a ar r r r * * * *b b b bu u┆ 0x02a0…02c0 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 08 69 08 69 6e ┆ u uf f f f; ; ; ; i i i in┆ 0x02c0…02e0 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 62 79 08 79 08 ┆ n n nt t t t n n n nb b b by y ┆ 0x02e0…0300 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 08 3b 08 3b 0a ┆y yt t t te e e es s s s; ; ; ; ┆ 0x0300…0320 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 63 08 63 08 63 ┆ # # # #i i i in n n nc c c┆ 0x0320…0340 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 65 08 65 20 3c ┆ cl l l lu u u ud d d de e e e <┆ 0x0340…0360 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 2f 08 2f 08 2f ┆ < < <s s s sy y y ys s s s/ / /┆ 0x0360…0380 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 65 08 65 73 08 ┆ /t t t ty y y yp p p pe e e es ┆ 0x0380…03a0 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 20 20 20 20 20 ┆s s s. . . .h h h h> > > > ┆ 0x03a0…03c0 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 63 6c 08 6c 08 ┆# # # #i i i in n n nc c c cl l ┆ 0x03c0…03e0 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 3c 08 3c 08 3c ┆l lu u u ud d d de e e e < < < <┆ 0x03e0…0400 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 2f 69 08 69 08 ┆s s s sy y y ys s s s/ / / /i i ┆ 0x0400…0420 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 08 63 08 63 2e ┆i io o o ov v v ve e e ec c c c.┆ 0x0420…0440 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 08 23 08 23 08 ┆ . . .h h h h> > > > # # # ┆ 0x0440…0460 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 08 6c 75 08 75 ┆#i i i in n n nc c c cl l l lu u┆ 0x0460…0480 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 08 73 08 73 08 ┆ u ud d d de e e e < < < <s s s ┆ 0x0480…04a0 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 08 66 69 08 69 ┆sy y y ys s s s/ / / /f f f fi i┆ 0x04a0…04c0 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 68 08 68 08 68 ┆ i il l l le e e e. . . .h h h h┆ 0x04c0…04e0 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 63 20 3d 08 3d ┆> > > > c c c cc c c c = =┆ 0x04e0…0500 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 08 64 08 64 08 ┆ = = r r r re e e ea a a ad d d ┆ 0x0500…0520 64 76 08 76 08 76 08 76 72 08 72 08 72 08 72 61 08 61 08 61 08 61 6e 08 6e 08 6e 08 6e 64 08 64 ┆dv v v vr r r ra a a an n n nd d┆ 0x0520…0540 08 64 08 64 6f 08 6f 08 6f 08 6f 6d 08 6d 08 6d 08 6d 28 08 28 08 28 08 28 66 08 66 08 66 08 66 ┆ d do o o om m m m( ( ( (f f f f┆ 0x0540…0560 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08 66 66 08 66 ┆d d d d, , , , o o o of f f ff f┆ 0x0560…0580 08 66 08 66 73 08 73 08 73 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 2c 08 2c 08 2c 08 2c ┆ f fs s s se e e et t t t, , , ,┆ 0x0580…05a0 20 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 2c 08 2c 08 2c 08 2c 20 69 08 ┆ i i i io o o ov v v v, , , , i ┆ 0x05a0…05c0 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 63 08 63 08 63 08 63 6e 08 6e 08 6e 08 ┆i i io o o ov v v vc c c cn n n ┆ 0x05c0…05e0 6e 74 08 74 08 74 08 74 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 ┆nt t t t) ) ) ) i i i in n ┆ 0x05e0…0600 6e 08 6e 74 08 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 ┆n nt t t t c c c cc c c c, , , ,┆ 0x0600…0620 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08 66 66 08 66 08 66 08 66 73 08 73 08 73 08 73 65 08 65 ┆ o o o of f f ff f f fs s s se e┆ 0x0620…0640 08 65 08 65 74 08 74 08 74 08 74 2c 08 2c 08 2c 08 2c 20 66 08 66 08 66 08 66 64 08 64 08 64 08 ┆ e et t t t, , , , f f f fd d d ┆ 0x0640…0660 64 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 73 08 73 08 73 08 73 74 08 74 08 74 08 74 72 08 72 08 ┆d; ; ; ; s s s st t t tr r ┆ 0x0660…0680 72 08 72 75 08 75 08 75 08 75 63 08 63 08 63 08 63 74 08 74 08 74 08 74 20 69 08 69 08 69 08 69 ┆r ru u u uc c c ct t t t i i i i┆ 0x0680…06a0 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 65 08 65 08 65 08 65 63 08 63 08 63 08 63 20 2a 08 2a ┆o o o ov v v ve e e ec c c c * *┆ 0x06a0…06c0 08 2a 08 2a 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 3b 08 3b 08 3b 08 3b ┆ * *i i i io o o ov v v v; ; ; ;┆ 0x06c0…06e0 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 69 08 69 08 ┆ i i i in n n nt t t t i i ┆ 0x06e0…0700 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 08 76 63 08 63 08 63 08 63 6e 08 6e 08 6e 08 6e 74 ┆i io o o ov v v vc c c cn n n nt┆ 0x0700…0720 08 74 08 74 08 74 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 ┆ t t t; ; ; ; D D D DE E E ES S┆ 0x0720…0740 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 ┆ S SC C C CR R R RI I I IP P P P┆ 0x0740…0760 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 ┆T T T TI I I IO O O ON N N N ┆ 0x0760…0780 20 20 54 68 65 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 5f 08 72 5f 08 61 5f 08 6e 5f 08 64 5f 08 ┆ The _ r_ e_ a_ d_ r_ a_ n_ d_ ┆ 0x0780…07a0 6f 5f 08 6d 20 61 6e 64 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 5f 08 76 5f 08 72 5f 08 61 5f 08 ┆o_ m and _ r_ e_ a_ d_ v_ r_ a_ ┆ 0x07a0…07c0 6e 5f 08 64 5f 08 6f 5f 08 6d 20 63 61 6c 6c 73 20 72 65 61 64 20 61 20 73 70 65 63 69 66 69 65 ┆n_ d_ o_ m calls read a specifie┆ 0x07c0…07e0 64 20 61 6d 6f 75 6e 74 0a 20 20 20 20 20 6f 66 20 64 61 74 61 20 66 72 6f 6d 20 61 20 66 69 6c ┆d amount of data from a fil┆ 0x07e0…0800 65 20 6f 62 6a 65 63 74 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e 20 20 54 68 65 20 64 61 74 61 20 ┆e object into memory. The data ┆ 0x0800…0820 69 73 20 72 65 61 64 20 61 74 0a 20 20 20 20 20 61 20 73 70 65 63 69 66 69 65 64 20 6f 66 66 73 ┆is read at a specified offs┆ 0x0820…0840 65 74 20 66 72 6f 6d 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 66 69 6c ┆et from the beginning of the fil┆ 0x0840…0860 65 20 6f 62 6a 65 63 74 0a 20 20 20 20 20 74 68 61 74 20 69 73 20 72 65 66 65 72 65 6e 63 65 64 ┆e object that is referenced┆ 0x0860…0880 20 62 79 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 0a 0a 20 20 ┆ by an open file descriptor. ┆ 0x0880…08a0 20 20 20 63 08 63 08 63 08 63 63 08 63 08 63 08 63 20 20 20 43 6f 6e 74 61 69 6e 73 20 74 68 65 ┆ c c c cc c c c Contains the┆ 0x08a0…08c0 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, ┆ 0x08c0…08e0 6f 72 20 2d 31 20 69 66 20 61 6e 0a 20 20 20 20 20 20 20 20 20 20 65 72 72 6f 72 20 6f 63 63 75 ┆or -1 if an error occu┆ 0x08e0…0900 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 ┆ 0x0900…0920 65 6e 64 2d 6f 66 2d 66 69 6c 65 20 68 61 73 0a 20 20 20 20 20 20 20 20 20 20 62 65 65 6e 20 72 ┆end-of-file has been r┆ 0x0920…0940 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┆ 0x0940…0960 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┆ 0x0960…0980 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┆ 0x0980…09a0 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┆ 0x09a0…09c0 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┆ 0x09c0…09e0 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┆ 0x09e0…0a00 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 ┆ 0x0a00…0a20 20 5f 08 66 5f 08 64 20 61 72 67 75 6d 65 6e 74 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f ┆ _ f_ d argument. IO_┆ 0x0a20…0a40 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┆ 0x0a40…0a60 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┆ 0x0a60…0a80 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┆ 0x0a80…0aa0 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┆ 0x0aa0…0ac0 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 72 ┆lag is set, the r┆ 0x0ac0…0ae0 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 20 63 61 75 73 65 73 20 73 68 61 72 65 64 20 62 6c 6f 63 ┆ead operation causes shared bloc┆ 0x0ae0…0b00 6b 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 ┆k-level locks to ┆ 0x0b00…0b20 62 65 20 73 65 74 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 ┆be set on the blocks involved in┆ 0x0b20…0b40 20 74 68 65 20 72 65 61 64 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 50 72 6f 63 65 ┆ the read. (Proce┆ 0x0b40…0b60 73 73 65 73 20 69 6e 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 ┆sses in a transaction acquire bl┆ 0x0b60…0b80 6f 63 6b 2d 6c 65 76 65 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 73 20 61 ┆ock-level locks a┆ 0x0b80…0ba0 75 74 6f 6d 61 74 69 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 ┆utomatically. An attempt to acq┆ 0x0ba0…0bc0 75 69 72 65 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 6f 6e ┆uire this lock on┆ 0x0bc0…0be0 20 61 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 66 69 6c 65 20 77 6f 75 6c 64 20 62 65 20 69 67 6e 6f ┆ a controlled file would be igno┆ 0x0be0…0c00 72 65 64 2e 29 20 54 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4d 42 4c 4f ┆red.) The IO_MBLO┆ 0x0c00…0c20 43 4b 20 66 6c 61 67 20 69 73 20 6d 61 70 70 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f 20 ┆CK flag is mapped internally to ┆ 0x0c20…0c40 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 43 4b ┆IO_MBLOCKS. IO_MBLOCK┆ 0x0c40…0c60 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 6f 6c ┆H Applies a ``hol┆ 0x0c60…0c80 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 64 20 ┆d'' lock to each block accessed ┆ 0x0c80…0ca0 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 62 79 ┆in a data file by┆ 0x0ca0…0cc0 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 6f 63 ┆ the read operation. A hold loc┆ 0x0cc0…0ce0 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 68 61 ┆k is stronger tha┆ 0x0ce0…0d00 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 6e 0a ┆n a shared lock, weaker than an ┆ 0x0d00…0d20 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 20 61 ┆ exclusive lock, a┆ 0x0d20…0d40 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 68 65 ┆nd incompatible with itself. The┆ 0x0d40…0d60 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 63 61 ┆ flag argument ca┆ 0x0d60…0d80 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 6f 64 ┆n be used inside transaction mod┆ 0x0d80…0da0 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 65 20 ┆e to acquire the ┆ 0x0da0…0dc0 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 20 74 ┆stronger hold lock rather than t┆ 0x0dc0…0de0 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 65 64 ┆he default shared┆ 0x0de0…0e00 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 6d 6f ┆ lock, or outside transaction mo┆ 0x0e00…0e20 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 72 20 ┆de to upgrade or ┆ 0x0e20…0e40 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 6f 70 ┆acquire the hold lock. The scop┆ 0x0e40…0e60 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 65 70 ┆e of the lock dep┆ 0x0e60…0e80 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 20 69 ┆ends on whether the process is i┆ 0x0e80…0ea0 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 65 20 ┆nside or outside ┆ 0x0ea0…0ec0 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 6f 6e ┆transaction mode. In transction┆ 0x0ec0…0ee0 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 20 69 ┆ mode, the lock i┆ 0x0ee0…0f00 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 6f 6d ┆s held until the transaction com┆ 0x0f00…0f20 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 20 77 ┆mits or aborts, w┆ 0x0f20…0f40 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 79 2e ┆hen it is removed automatically.┆ 0x0f40…0f60 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 63 74 ┆ Outside transct┆ 0x0f60…0f80 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 61 6c ┆ion mode the lock must be manual┆ 0x0f80…0fa0 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 67 20 ┆ly removed using ┆ 0x0fa0…0fc0 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┆ 0x0fc0…0fe0 6c 6c 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 20 ┆ll. Any attempt to ┆ 0x0fe0…1000 20 20 20 20 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 ┆ remove the lock manuall┆ 0x1000…1020 79 20 77 69 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 ┆y within a transaction will ┆ 0x1020…1040 20 20 20 20 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 ┆ be deferred until the┆ 0x1040…1060 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 20 6f 72 0a 20 20 20 20 20 20 20 20 ┆ transaction commits or ┆ 0x1060…1080 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 73 65 ┆ aborts. This lock is use┆ 0x1080…10a0 64 20 74 6f 20 64 65 73 69 67 6e 20 70 72 6f 74 6f 63 6f 6c 73 0a 20 20 20 20 20 20 20 20 20 20 ┆d to design protocols ┆ 0x10a0…10c0 20 20 20 20 20 74 68 61 74 20 61 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b 20 28 77 69 74 68 20 72 ┆ that avoid deadlock (with r┆ 0x10c0…10e0 65 64 75 63 65 64 20 63 6f 6e 63 75 72 72 65 6e 63 79 29 2e 0a 20 20 20 20 20 20 20 20 20 20 20 ┆educed concurrency). ┆ 0x10e0…1100 20 20 20 20 53 65 65 20 74 68 65 20 54 08 54 08 54 08 54 58 08 58 08 58 08 58 20 50 08 50 08 50 ┆ See the T T T TX X X X P P P┆ 0x1100…1120 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 61 08 ┆ Pr r r ro o o og g g gr r r ra ┆ 0x1120…1140 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 72 08 ┆a a am m m mm m m me e e er r r ┆ 0x1140…1160 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 69 08 ┆r' ' ' 's s s s G G G Gu u u ui ┆ 0x1160…1180 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 73 2e ┆i i id d d de e e e for details.┆ 0x1180…11a0 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 20 20 ┆ IO_MBLOCKS ┆ 0x11a0…11c0 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 65 6c ┆ Applies shared block-level┆ 0x11c0…11e0 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 20 20 ┆ locks to each block ┆ 0x11e0…1200 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 20 74 ┆ accessed in a data file by t┆ 0x1200…1220 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 20 20 ┆he read operation. ┆ 0x1220…1240 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 2d 63 ┆ The lock applies only to non-c┆ 0x1240…1260 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 20 20 ┆ontrolled files. ┆ 0x1260…1280 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 6e 73 ┆The flag is ignored inside trans┆ 0x1280…12a0 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 20 20 ┆actions as shared ┆ 0x12a0…12c0 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 64 20 ┆ block-level locks are acquired ┆ 0x12c0…12e0 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 20 20 ┆automatically on ┆ 0x12e0…1300 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 0a 20 ┆reading. IO_MBLOCKX ┆ 0x1300…1320 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 73 69 ┆ Applies an exclusi┆ 0x1320…1340 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 0a 20 ┆ve lock to each block accessed ┆ 0x1340…1360 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 79 20 ┆ in a data file by ┆ 0x1360…1380 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 20 20 ┆the read operation. The flag ┆ 0x1380…13a0 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 73 65 ┆ argument can be use┆ 0x13a0…13c0 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 20 20 ┆d inside transaction mode to ┆ 0x13c0…13e0 20 20 20 20 20 20 20 20 20 20 20 20 61 71 75 69 72 65 20 74 68 65 20 73 74 72 6f 6e 67 65 72 20 ┆ aquire the stronger ┆ 0x13e0…1400 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 20 74 68 65 0a 20 ┆exclusive lock rather than the ┆ 0x1400…1420 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 65 64 20 6c 6f 63 ┆ default shared loc┆ 0x1420…1440 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 6d 6f 64 65 0a 20 ┆k, or outside transaction mode ┆ 0x1440…1460 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 72 20 61 63 71 75 ┆ to upgrade or acqu┆ 0x1460…1480 69 72 65 20 74 68 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 2e 20 20 54 68 65 0a 20 20 20 ┆ire the exclusive lock. The ┆ 0x1480…14a0 20 20 20 20 20 20 20 20 20 20 20 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 6c 6f 63 6b 20 64 65 ┆ scope of the lock de┆ 0x14a0…14c0 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 0a 20 20 20 ┆pends on whether the process ┆ 0x14c0…14e0 20 20 20 20 20 20 20 20 20 20 20 20 69 73 20 69 6e 73 69 64 65 20 6f 72 20 6f 75 74 73 69 64 65 ┆ is inside or outside┆ 0x14e0…1500 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 2d 0a 20 ┆ transaction mode. In transc- ┆ 0x1500…1520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 69 6f 6e 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f 63 ┆ tion mode, the loc┆ 0x1520…1540 6b 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 0a ┆k is held until the transaction ┆ 0x1540…1560 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6d 6d 69 74 73 20 6f 72 20 61 62 6f 72 74 73 ┆ commits or aborts┆ 0x1560…1580 2c 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 2d 0a 20 ┆, when it is removed automati- ┆ 0x1580…15a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6c 6c 79 2e 20 20 4f 75 74 73 69 64 65 20 74 72 ┆ cally. Outside tr┆ 0x15a0…15c0 61 6e 73 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 0a 20 ┆ansction mode the lock must be ┆ 0x15c0…15e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 61 6e 75 61 6c 6c 79 20 72 65 6d 6f 76 65 64 20 75 ┆ manually removed u┆ 0x15e0…1600 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 73 74 ┆sing the _ m_ b_ l_ o_ c_ k syst┆ 0x1600…1620 65 6d 20 63 61 6c 6c 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 6e 79 20 61 74 74 65 ┆em call. Any atte┆ 0x1620…1640 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 6c 79 20 ┆mpt to remove the lock manually ┆ 0x1640…1660 77 69 74 68 69 6e 20 61 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 61 63 74 ┆within a transact┆ 0x1660…1680 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 65 20 74 ┆ion will be deferred until the t┆ 0x1680…16a0 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6d 6d 69 74 ┆ransaction commit┆ 0x16a0…16c0 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 4c 4f 43 ┆s or aborts. IO_NBLOC┆ 0x16c0…16e0 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 61 74 20 ┆K Specifies that ┆ 0x16e0…1700 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 2c 0a 20 ┆the read is to be nonblocking, ┆ 0x1700…1720 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 68 65 20 ┆ regardless of the ┆ 0x1720…1740 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 73 0a 20 ┆default action for I/O on this ┆ 0x1740…1760 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 20 61 20 ┆ descriptor. If a ┆ 0x1760…1780 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 65 0a 20 ┆blocking condition occurs, the ┆ 0x1780…17a0 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 20 20 20 ┆ read fails. ┆ 0x17a0…17c0 20 20 20 20 20 49 4f 5f 4e 42 4c 4f 43 4b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 ┆ IO_NBLOCK Sp┆ 0x17c0…17e0 65 63 69 66 69 65 73 20 74 68 61 74 20 74 68 65 20 72 65 61 64 20 69 73 20 74 6f 20 62 65 20 6e ┆ecifies that the read is to be n┆ 0x17e0…1800 6f 6e 62 6c 6f 63 6b 69 6e 67 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 67 61 72 ┆onblocking, regar┆ 0x1800…1820 64 6c 65 73 73 20 6f 66 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 66 6f 72 20 ┆dless of the default action for ┆ 0x1820…1840 49 2f 4f 20 6f 6e 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 73 63 72 ┆I/O on this descr┆ 0x1840…1860 69 70 74 6f 72 2e 20 20 49 66 20 61 20 62 6c 6f 63 6b 69 6e 67 20 63 6f 6e 64 69 74 69 6f 6e 20 ┆iptor. If a blocking condition ┆ 0x1860…1880 6f 63 63 75 72 73 2c 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 61 64 20 ┆occurs, the read ┆ 0x1880…18a0 66 61 69 6c 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 53 49 47 45 52 52 0a 20 20 20 20 ┆fails. IO_SIGERR ┆ 0x18a0…18c0 20 20 20 20 20 20 20 20 20 20 20 47 65 6e 65 72 61 74 65 20 53 49 47 45 52 52 20 61 6e 64 20 53 ┆ Generate SIGERR and S┆ 0x18c0…18e0 49 47 50 49 50 45 20 73 69 67 6e 61 6c 73 2e 20 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 5f 08 72 ┆IGPIPE signals. _ r_ e_ a_ d_ r┆ 0x18e0…1900 5f 08 61 5f 08 6e 5f 08 64 5f 08 6f 5f 08 6d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 ┆_ a_ n_ d_ o_ m d┆ 0x1900…1920 6f 65 73 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 61 74 65 20 ┆oes not returns the appropriate ┆ […truncated at 200 lines…]