|
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: 15571 (0x3cd3)
Names: »read.2«
└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
└─⟦bbf173f5c⟧ »0004«
└─⟦this⟧ »./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 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 ┆ X X X i i i in n n nt t t ┆ 0x00e0…0100 74 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 08 ┆t r r r re e e ea a a ad d d d( ┆ 0x0100…0120 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 62 ┆( ( (f f f fd d d d, , , , b b b┆ 0x0120…0140 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 62 ┆ bu u u uf f f f, , , , n n n nb┆ 0x0140…0160 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 73 ┆ b b by y y yt t t te e e es s s┆ 0x0160…0180 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 74 ┆ s) ) ) ) i i i in n n nt t┆ 0x0180…01a0 08 74 08 74 20 66 08 66 08 66 08 66 64 08 64 08 64 08 64 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 ┆ t t f f f fd d d d; ; ; ; ┆ 0x01a0…01c0 63 08 63 08 63 08 63 68 08 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a ┆c c c ch h h ha a a ar r r r * *┆ 0x01c0…01e0 08 2a 08 2a 62 08 62 08 62 08 62 75 08 75 08 75 08 75 66 08 66 08 66 08 66 3b 08 3b 08 3b 08 3b ┆ * *b b b bu u u uf f f f; ; ; ;┆ 0x01e0…0200 0a 20 20 20 20 20 75 08 75 08 75 08 75 6e 08 6e 08 6e 08 6e 73 08 73 08 73 08 73 69 08 69 08 69 ┆ u u u un n n ns s s si i i┆ 0x0200…0220 08 69 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 65 08 65 08 65 08 65 64 08 64 08 64 08 64 20 6e ┆ ig g g gn n n ne e e ed d d d n┆ 0x0220…0240 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 65 08 65 ┆ n n nb b b by y y yt t t te e e┆ 0x0240…0260 08 65 73 08 73 08 73 08 73 3b 08 3b 08 3b 08 3b 0a 0a 20 20 20 20 20 23 08 23 08 23 08 23 69 08 ┆ es s s s; ; ; ; # # # #i ┆ 0x0260…0280 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 08 75 08 ┆i i in n n nc c c cl l l lu u u ┆ 0x0280…02a0 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 73 79 08 ┆ud d d de e e e < < < <s s s sy ┆ 0x02a0…02c0 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 74 08 74 08 74 08 74 79 08 79 08 79 08 ┆y y ys s s s/ / / /t t t ty y y ┆ 0x02c0…02e0 79 70 08 70 08 70 08 70 65 08 65 08 65 08 65 73 08 73 08 73 08 73 2e 08 2e 08 2e 08 2e 68 08 68 ┆yp p p pe e e es s s s. . . .h h┆ 0x02e0…0300 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 20 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69 6e ┆ h h> > > > # # # #i i i in┆ 0x0300…0320 08 6e 08 6e 08 6e 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 ┆ n n nc c c cl l l lu u u ud d d┆ 0x0320…0340 08 64 65 08 65 08 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 ┆ de e e e < < < <s s s sy y y ys┆ 0x0340…0360 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 76 08 76 ┆ s s s/ / / /i i i io o o ov v v┆ 0x0360…0380 08 76 65 08 65 08 65 08 65 63 08 63 08 63 08 63 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 ┆ ve e e ec c c c. . . .h h h h> ┆ 0x0380…03a0 3e 08 3e 08 3e 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┆ 0x03a0…03c0 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 ┆ 0x03c0…03e0 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┆ 0x03e0…0400 2f 08 2f 08 2f 08 2f 66 08 66 08 66 08 66 69 08 69 08 69 08 69 6c 08 6c 08 6c 08 6c 65 08 65 08 ┆/ / / /f f f fi i i il l l le e ┆ 0x0400…0420 65 08 65 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 69 ┆e e. . . .h h h h> > > > i┆ 0x0420…0440 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 72 08 72 08 72 08 72 65 08 65 08 ┆ i i in n n nt t t t r r r re e ┆ 0x0440…0460 65 08 65 61 08 61 08 61 08 61 64 08 64 08 64 08 64 76 08 76 08 76 08 76 28 08 28 08 28 08 28 66 ┆e ea a a ad d d dv v v v( ( ( (f┆ 0x0460…0480 08 66 08 66 08 66 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 69 08 69 08 69 08 69 6f 08 6f 08 ┆ f f fd d d d, , , , i i i io o ┆ 0x0480…04a0 6f 08 6f 76 08 76 08 76 08 76 2c 08 2c 08 2c 08 2c 20 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f ┆o ov v v v, , , , i i i io o o o┆ 0x04a0…04c0 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 29 08 29 08 ┆v v v vc c c cn n n nt t t t) ) ┆ 0x04c0…04e0 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 74 08 74 08 74 20 66 ┆) ) i i i in n n nt t t t f┆ 0x04e0…0500 08 66 08 66 08 66 64 08 64 08 64 08 64 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 73 08 73 08 73 08 ┆ f f fd d d d; ; ; ; s s s ┆ 0x0500…0520 73 74 08 74 08 74 08 74 72 08 72 08 72 08 72 75 08 75 08 75 08 75 63 08 63 08 63 08 63 74 08 74 ┆st t t tr r r ru u u uc c c ct t┆ 0x0520…0540 08 74 08 74 20 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 ┆ t t i i i io o o ov v v ve e e ┆ 0x0540…0560 65 63 08 63 08 63 08 63 20 2a 08 2a 08 2a 08 2a 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 76 08 ┆ec c c c * * * *i i i io o o ov ┆ 0x0560…0580 76 08 76 08 76 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e ┆v v v; ; ; ; i i i in n n n┆ 0x0580…05a0 74 08 74 08 74 08 74 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 ┆t t t t i i i io o o ov v v vc c┆ 0x05a0…05c0 08 63 08 63 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 ┆ c cn n n nt t t t; ; ; ; D D D┆ 0x05c0…05e0 08 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 ┆ DE E E ES S S SC C C CR R R RI ┆ 0x05e0…0600 49 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 ┆I I IP P P PT T T TI I I IO O O ┆ 0x0600…0620 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 20 61 ┆ON N N N The _ r_ e_ a_ d a┆ 0x0620…0640 6e 64 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 5f 08 76 20 63 61 6c 6c 73 20 72 65 61 64 20 61 20 ┆nd _ r_ e_ a_ d_ v calls read a ┆ 0x0640…0660 73 70 65 63 69 66 69 65 64 20 61 6d 6f 75 6e 74 20 6f 66 20 64 61 74 61 0a 20 20 20 20 20 69 6e ┆specified amount of data in┆ 0x0660…0680 74 6f 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 61 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 74 68 61 ┆to memory from a file object tha┆ 0x0680…06a0 74 20 69 73 20 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 61 6e 20 6f 70 65 6e 0a 20 20 20 20 20 ┆t is referenced by an open ┆ 0x06a0…06c0 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 42 6f 74 68 20 66 75 6e 63 74 69 6f 6e 73 ┆file descriptor. Both functions┆ 0x06c0…06e0 20 72 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 0a 20 20 20 20 ┆ return the number of bytes ┆ 0x06e0…0700 20 61 63 74 75 61 6c 6c 79 20 72 65 61 64 2c 20 6f 72 20 2d 31 20 69 66 20 61 6e 20 65 72 72 6f ┆ actually read, or -1 if an erro┆ 0x0700…0720 72 20 6f 63 63 75 72 65 64 2e 20 49 66 20 65 6e 64 2d 6f 66 2d 66 69 6c 65 20 69 73 0a 20 20 20 ┆r occured. If end-of-file is ┆ 0x0720…0740 20 20 72 65 61 63 68 65 64 2c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 6e 20 ┆ reached, the functions return ┆ 0x0740…0760 30 2e 0a 0a 20 20 20 20 20 49 66 20 61 20 5f 08 72 5f 08 65 5f 08 61 5f 08 64 20 69 73 20 69 6e ┆0. If a _ r_ e_ a_ d is in┆ 0x0760…0780 74 65 72 72 75 70 74 65 64 20 62 79 20 61 20 73 69 67 6e 61 6c 20 62 65 66 6f 72 65 20 69 74 20 ┆terrupted by a signal before it ┆ 0x0780…07a0 72 65 61 64 73 20 61 6e 79 0a 20 20 20 20 20 64 61 74 61 2c 20 69 74 20 77 69 6c 6c 20 72 65 74 ┆reads any data, it will ret┆ 0x07a0…07c0 75 72 6e 20 2d 31 20 77 69 74 68 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 73 65 74 20 ┆urn -1 with _ e_ r_ r_ n_ o set ┆ 0x07c0…07e0 74 6f 20 5b 45 49 4e 54 52 5d 2e 0a 0a 20 20 20 20 20 49 66 20 61 20 5f 08 72 5f 08 65 5f 08 61 ┆to [EINTR]. If a _ r_ e_ a┆ 0x07e0…0800 5f 08 64 20 69 73 20 69 6e 74 65 72 72 75 70 74 65 64 20 62 79 20 61 20 73 69 67 6e 61 6c 20 61 ┆_ d is interrupted by a signal a┆ 0x0800…0820 66 74 65 72 20 69 73 20 68 61 73 20 73 75 63 63 73 73 2d 0a 20 20 20 20 20 66 75 6c 6c 79 20 72 ┆fter is has succss- fully r┆ 0x0820…0840 65 61 64 20 73 6f 6d 65 20 64 61 74 61 2c 20 69 74 20 72 65 74 75 72 6e 73 20 2d 31 20 77 69 74 ┆ead some data, it returns -1 wit┆ 0x0840…0860 68 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 73 65 74 20 74 6f 0a 20 20 20 20 20 5b 45 ┆h _ e_ r_ r_ n_ o set to [E┆ 0x0860…0880 49 4e 54 52 5d 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 73 ┆INTR]. f f f fd d d d Is┆ 0x0880…08a0 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 20 ┆ an open file descriptor of the ┆ 0x08a0…08c0 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 68 ┆file object from which┆ 0x08c0…08e0 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 6c ┆ the data will be read. The fol┆ 0x08e0…0900 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 74 ┆lowing flag argu- ment┆ 0x0900…0920 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 65 ┆s are _ o_ red ( | ) with the le┆ 0x0920…0940 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 20 ┆ftmost 16 bits of the ┆ 0x0940…0960 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 4d ┆_ f_ d argument: IO_M┆ 0x0960…0980 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 6c ┆BLOCK Applies onl┆ 0x0980…09a0 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 5f ┆y to disk files that are _ n_ o_┆ 0x09a0…09c0 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 68 ┆ t opened with th┆ 0x09c0…09e0 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 6c ┆e O_CONTROL flag set. If the fl┆ 0x09e0…0a00 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 08 ┆ag is set, the _ ┆ 0x0a00…0a20 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 6c ┆r_ e_ a_ d causes shared block-l┆ 0x0a20…0a40 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 20 ┆evel locks to be set ┆ 0x0a40…0a60 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 68 ┆ on the blocks involved in th┆ 0x0a60…0a80 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 20 ┆e read. (Processes in ┆ 0x0a80…0aa0 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 6b ┆ a transaction acquire block┆ 0x0aa0…0ac0 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 20 ┆-level locks automati- ┆ 0x0ac0…0ae0 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 75 ┆ cally. An attempt to acqu┆ 0x0ae0…0b00 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 20 ┆ire this lock on a con- ┆ 0x0b00…0b20 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 6e ┆ trolled file would be ign┆ 0x0b20…0b40 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 20 ┆ored.) The IO_MBLOCK flag ┆ 0x0b40…0b60 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 6f ┆ is mapped internally to┆ 0x0b60…0b80 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 43 ┆ IO_MBLOCKS. IO_MBLOC┆ 0x0b80…0ba0 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 6f ┆KH Applies a ``ho┆ 0x0ba0…0bc0 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 64 ┆ld'' lock to each block accessed┆ 0x0bc0…0be0 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 62 ┆ in a data file b┆ 0x0be0…0c00 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 6f ┆y the read operation. A hold lo┆ 0x0c00…0c20 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 68 ┆ck is stronger th┆ 0x0c20…0c40 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 6e ┆an a shared lock, weaker than an┆ 0x0c40…0c60 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 20 ┆ exclusive lock, ┆ 0x0c60…0c80 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 68 ┆and incompatible with itself. Th┆ 0x0c80…0ca0 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 63 ┆e flag argument c┆ 0x0ca0…0cc0 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 6f ┆an be used inside transaction mo┆ 0x0cc0…0ce0 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 65 ┆de to acquire the┆ 0x0ce0…0d00 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 20 ┆ stronger hold lock rather than ┆ 0x0d00…0d20 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 65 ┆the default share┆ 0x0d20…0d40 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 6d ┆d lock, or outside transaction m┆ 0x0d40…0d60 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 72 ┆ode to upgrade or┆ 0x0d60…0d80 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 6f ┆ acquire the hold lock. The sco┆ 0x0d80…0da0 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 65 ┆pe of the lock de┆ 0x0da0…0dc0 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 20 ┆pends on whether the process is ┆ 0x0dc0…0de0 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 65 ┆inside or outside┆ 0x0de0…0e00 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 6f ┆ transaction mode. In transctio┆ 0x0e00…0e20 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 20 ┆n mode, the lock ┆ 0x0e20…0e40 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 6f ┆is held until the transaction co┆ 0x0e40…0e60 6d 6d 69 74 73 20 6f 72 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 62 ┆mmits or ab┆ 0x0e60…0e80 6f 72 74 73 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 ┆orts, when it is removed automat┆ 0x0e80…0ea0 69 63 61 6c 6c 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 ┆ically. Outside ┆ 0x0ea0…0ec0 74 72 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 ┆transction mode the lock must be┆ 0x0ec0…0ee0 20 6d 61 6e 75 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 ┆ manually removed ┆ 0x0ee0…0f00 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┆ 0x0f00…0f20 73 74 65 6d 20 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 ┆stem call. Any attempt to ┆ 0x0f20…0f40 20 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 ┆ remove the lock manual┆ 0x0f40…0f60 6c 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 ┆ly within a transaction will ┆ 0x0f60…0f80 20 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 ┆ be deferred until th┆ 0x0f80…0fa0 65 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 ┆e transaction commits or ┆ 0x0fa0…0fc0 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 73 ┆ aborts. This lock is us┆ 0x0fc0…0fe0 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 20 ┆ed to design protocols to ┆ 0x0fe0…1000 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 72 ┆ avoid deadlocks (with r┆ 0x1000…1020 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 20 ┆educed concurrency). See ┆ 0x1020…1040 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 08 ┆ the T T T TX X X X P P ┆ 0x1040…1060 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 61 ┆P Pr r r ro o o og g g gr r r ra┆ 0x1060…1080 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 72 ┆ a a am m m mm m m me e e er r r┆ 0x1080…10a0 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 69 ┆ r' ' ' 's s s s G G G Gu u u ui┆ 0x10a0…10c0 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 73 ┆ i i id d d de e e e for details┆ 0x10c0…10e0 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 20 ┆. IO_MBLOCKS ┆ 0x10e0…1100 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 65 ┆ Applies shared block-leve┆ 0x1100…1120 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 20 ┆l locks to each block ┆ 0x1120…1140 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 20 ┆ accessed in a data file by ┆ 0x1140…1160 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 20 ┆the read operation. ┆ 0x1160…1180 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 2d ┆ The lock applies only to non-┆ 0x1180…11a0 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 20 ┆controlled files. ┆ 0x11a0…11c0 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 6e ┆ The flag is ignored inside tran┆ 0x11c0…11e0 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 20 ┆sactions as shared ┆ 0x11e0…1200 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 64 ┆ block-level locks are acquired┆ 0x1200…1220 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 20 ┆ automatically on ┆ 0x1220…1240 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 0a ┆ reading. IO_MBLOCKX ┆ 0x1240…1260 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 73 ┆ Applies an exclus┆ 0x1260…1280 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 0a ┆ive lock to each block accessed ┆ 0x1280…12a0 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 79 ┆ in a data file by┆ 0x12a0…12c0 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 20 ┆ the read operation. The flag ┆ 0x12c0…12e0 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 73 ┆ argument can be us┆ 0x12e0…1300 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 20 ┆ed inside transaction mode to ┆ 0x1300…1320 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 65 ┆ acquire the stronge┆ 0x1320…1340 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 20 ┆r exclusive lock rather than ┆ 0x1340…1360 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 6c ┆ the default shared l┆ 0x1360…1380 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 20 ┆ock, or outside transaction ┆ 0x1380…13a0 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 63 ┆ mode to upgrade or ac┆ 0x13a0…13c0 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 20 ┆quire the exclusive lock. ┆ 0x13c0…13e0 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 64 ┆ The scope of the lock d┆ 0x13e0…1400 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 20 ┆epends on whether the pro- ┆ 0x1400…1420 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 73 ┆ cess is inside or outs┆ 0x1420…1440 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 20 ┆ide transaction mode. In ┆ 0x1440…1460 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 6f ┆ transction mode, the lo┆ 0x1460…1480 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 20 ┆ck is held until the tran- ┆ 0x1480…14a0 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 6f ┆ saction commits or abo┆ 0x14a0…14c0 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 20 ┆rts, when it is removed ┆ 0x14c0…14e0 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 74 ┆ automatically. Outside t┆ 0x14e0…1500 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 20 ┆ransction mode the lock ┆ 0x1500…1520 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 20 ┆ must be manually removed ┆ 0x1520…1540 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 73 ┆using the _ m_ b_ l_ o_ c_ k sys┆ 0x1540…1560 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 74 ┆tem call. Any at┆ 0x1560…1580 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 6c ┆tempt to remove the lock manuall┆ 0x1580…15a0 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 61 ┆y within a transa┆ 0x15a0…15c0 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 65 ┆ction will be deferred until the┆ 0x15c0…15e0 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 6d ┆ transaction comm┆ 0x15e0…1600 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 4c ┆its or aborts. IO_NBL┆ 0x1600…1620 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 61 ┆OCK Specifies tha┆ 0x1620…1640 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 2c ┆t the read is to be nonblocking,┆ 0x1640…1660 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 68 ┆ regardless of th┆ 0x1660…1680 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 73 ┆e default action for I/O on this┆ 0x1680…16a0 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 20 ┆ descriptor. If ┆ 0x16a0…16c0 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 65 ┆a blocking condition occurs, the┆ 0x16c0…16e0 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 20 ┆ read fails. ┆ 0x16e0…1700 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 20 ┆ IO_SIGERR ┆ 0x1700…1720 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 6e ┆Generate SIGERR and SIGPIPE sign┆ 0x1720…1740 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 20 ┆als. _ r_ e_ a_ d does ┆ 0x1740…1760 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 61 ┆ not returns the appropria┆ 0x1760…1780 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 20 ┆te error code, but gen- ┆ 0x1780…17a0 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 61 ┆ erates the signals instea┆ 0x17a0…17c0 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 20 ┆d. IO_NOSIGABORT ┆ 0x17c0…17e0 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 53 ┆ Do not generate the S┆ 0x17e0…1800 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 20 ┆IGABORT signal. The system ┆ 0x1800…1820 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 72 ┆ assumes that the user┆ 0x1820…1840 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 20 ┆ has supplied code at the ┆ 0x1840…1860 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 5f ┆ point of the _ r_ e_ a_┆ 0x1860…1880 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 74 ┆ d to detect and handle transact┆ 0x1880…18a0 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 61 ┆ion aborts. If a┆ 0x18a0…18c0 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 5f ┆ transaction abort does occur, _┆ 0x18c0…18e0 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 72 ┆ r_ e_ a_ d retur┆ 0x18e0…1900 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 20 ┆ns an error and _ e_ r_ r_ n_ o ┆ 0x1900…1920 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 20 ┆contains an indication ┆ […truncated at 200 lines…]