|
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: w
Length: 16421 (0x4025)
Names: »write.2«
└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
└─⟦bbf173f5c⟧ »0004«
└─⟦this⟧ »./usr/man/cat2/write.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 77 72 69 74 65 28 32 29 0a 0a 0a 0a ┆s write(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 77 72 69 74 65 2c 20 77 72 69 74 65 76 20 2d 20 77 72 69 74 65 20 6f 6e 20 61 20 66 69 6c ┆ write, writev - write on a fil┆ 0x00a0…00c0 65 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 54 08 54 08 54 41 ┆e S S S SY Y Y YN N N NT T T TA┆ 0x00c0…00e0 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 77 08 77 08 77 08 77 72 08 72 08 72 08 ┆ A A AX X X X w w w wr r r ┆ 0x00e0…0100 72 69 08 69 08 69 08 69 74 08 74 08 74 08 74 65 08 65 08 65 08 65 28 08 28 08 28 08 28 66 08 66 ┆ri i i it t t te e e e( ( ( (f f┆ 0x0100…0120 08 66 08 66 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 62 08 62 08 62 08 62 75 08 75 08 75 08 ┆ f fd d d d, , , , b b b bu u u ┆ 0x0120…0140 75 66 08 66 08 66 08 66 2c 08 2c 08 2c 08 2c 20 6e 08 6e 08 6e 08 6e 62 08 62 08 62 08 62 79 08 ┆uf f f f, , , , n n n nb b b by ┆ 0x0140…0160 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 29 08 29 08 29 08 ┆y y yt t t te e e es s s s) ) ) ┆ 0x0160…0180 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 08 66 ┆) i i i in n n nt t t t f f┆ 0x0180…01a0 08 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 ┆ f fd d d d; ; ; ; c c c ch┆ 0x01a0…01c0 08 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 ┆ h h ha a a ar r r r * * * *b b ┆ 0x01c0…01e0 62 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 ┆b bu u u uf f f f; ; ; ; i ┆ 0x01e0…0200 69 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 ┆i i in n n nt t t t n n n nb b b┆ 0x0200…0220 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 08 73 3b 08 ┆ by y y yt t t te e e es s s s; ┆ 0x0220…0240 3b 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 ┆; ; ; # # # #i i i in n n ┆ 0x0240…0260 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 08 64 65 08 65 ┆nc c c cl l l lu u u ud d d de e┆ 0x0260…0280 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 08 73 08 73 08 ┆ e e < < < <s s s sy y y ys s s ┆ 0x0280…02a0 73 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 ┆s/ / / /t t t ty y y yp p p pe e┆ 0x02a0…02c0 08 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 ┆ e es s s s. . . .h h h h> > > >┆ 0x02c0…02e0 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┆ 0x02e0…0300 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 <┆ 0x0300…0320 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/ / /┆ 0x0320…0340 08 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 ┆ /i i i io o o ov v v ve e e ec ┆ 0x0340…0360 63 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 ┆c c c. . . .h h h h> > > > ┆ 0x0360…0380 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 ┆ 0x0380…03a0 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 < < < <┆ 0x03a0…03c0 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 66 08 66 08 ┆s s s sy y y ys s s s/ / / /f f ┆ 0x03c0…03e0 66 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 ┆f fi i i il l l le e e e. . . .h┆ 0x03e0…0400 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 77 08 77 08 77 08 77 72 08 72 08 72 ┆ h h h> > > > w w w wr r r┆ 0x0400…0420 08 72 69 08 69 08 69 08 69 74 08 74 08 74 08 74 65 08 65 08 65 08 65 76 08 76 08 76 08 76 28 08 ┆ ri i i it t t te e e ev v v v( ┆ 0x0420…0440 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 69 08 69 08 69 ┆( ( (f f f fd d d d, , , , i i i┆ 0x0440…0460 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 69 08 69 08 69 6f ┆ io o o ov v v v, , , , i i i io┆ 0x0460…0480 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 08 74 08 74 ┆ o o ov v v vc c c cn n n nt t t┆ 0x0480…04a0 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 6e 08 6e 74 08 74 ┆ t) ) ) ) i i i in n n nt t┆ 0x04a0…04c0 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; ; ; ; ┆ 0x04c0…04e0 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 75 63 08 63 08 ┆s s s st t t tr r r ru u u uc c ┆ 0x04e0…0500 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 76 08 76 08 76 ┆c ct t t t i i i io o o ov v v v┆ 0x0500…0520 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 08 69 6f 08 6f ┆e e e ec c c c * * * *i i i io o┆ 0x0520…0540 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 08 69 08 69 6e ┆ o ov v v v; ; ; ; i i i in┆ 0x0540…0560 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 6f 76 08 76 08 ┆ n n nt t t t i i i io o o ov v ┆ 0x0560…0580 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 08 3b 08 3b 0a ┆v vc c c cn n n nt t t t; ; ; ; ┆ 0x0580…05a0 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 08 43 52 08 52 ┆ D D D DE E E ES S S SC C C CR R┆ 0x05a0…05c0 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 49 08 49 08 49 ┆ R RI I I IP P P PT T T TI I I I┆ 0x05c0…05e0 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 77 5f 08 72 5f 08 ┆O O O ON N N N The _ w_ r_ ┆ 0x05e0…0600 69 5f 08 74 5f 08 65 20 61 6e 64 20 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 5f 08 76 20 73 ┆i_ t_ e and _ w_ r_ i_ t_ e_ v s┆ 0x0600…0620 79 73 74 65 6d 20 63 61 6c 6c 73 20 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 73 ┆ystem calls attempt to write a s┆ 0x0620…0640 70 65 63 69 2d 0a 20 20 20 20 20 66 69 65 64 20 61 6d 6f 75 6e 74 20 6f 66 20 64 61 74 61 20 74 ┆peci- fied amount of data t┆ 0x0640…0660 6f 20 61 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 61 6e ┆o a file object referenced by an┆ 0x0660…0680 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 20 20 55 70 6f ┆ open file descriptor. Upo┆ 0x0680…06a0 6e 20 73 75 63 63 65 73 73 66 75 6c 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 74 68 65 20 66 75 6e ┆n successful completion, the fun┆ 0x06a0…06c0 63 74 69 6f 6e 73 0a 20 20 20 20 20 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 61 6e 64 20 ┆ctions _ w_ r_ i_ t_ e and ┆ 0x06c0…06e0 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 5f 08 76 20 72 65 74 75 72 6e 20 74 68 65 20 6e 75 ┆_ w_ r_ i_ t_ e_ v return the nu┆ 0x06e0…0700 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 61 63 74 75 61 6c 6c 79 20 77 72 69 74 74 65 6e 0a 20 ┆mber of bytes actually written ┆ 0x0700…0720 20 20 20 20 74 6f 20 74 68 65 20 66 69 6c 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 ┆ to the file associated with ┆ 0x0720…0740 5f 08 66 5f 08 64 2e 0a 0a 20 20 20 20 20 49 66 20 5f 08 6e 5f 08 62 5f 08 79 5f 08 74 5f 08 65 ┆_ f_ d. If _ n_ b_ y_ t_ e┆ 0x0740…0760 5f 08 73 20 69 73 20 7a 65 72 6f 2c 20 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 77 69 6c ┆_ s is zero, _ w_ r_ i_ t_ e wil┆ 0x0760…0780 6c 20 72 65 74 75 72 6e 20 7a 65 72 6f 20 61 6e 64 20 68 61 76 65 20 6e 6f 20 6f 74 68 65 72 0a ┆l return zero and have no other ┆ 0x0780…07a0 20 20 20 20 20 72 65 73 75 6c 74 73 2e 0a 0a 20 20 20 20 20 49 66 20 65 69 74 68 65 72 20 66 75 ┆ results. If either fu┆ 0x07a0…07c0 6e 63 74 69 6f 6e 20 72 65 71 75 65 73 74 73 20 74 6f 20 77 72 69 74 65 20 6d 6f 72 65 20 62 79 ┆nction requests to write more by┆ 0x07c0…07e0 74 65 73 20 74 68 61 74 20 63 61 6e 20 62 65 0a 20 20 20 20 20 77 72 69 74 74 65 6e 20 28 65 2e ┆tes that can be written (e.┆ 0x07e0…0800 67 2e 20 64 75 65 20 74 6f 20 70 68 79 73 69 63 61 6c 20 65 6e 64 20 6f 66 20 61 20 6d 65 64 69 ┆g. due to physical end of a medi┆ 0x0800…0820 75 6d 29 2c 20 6f 6e 6c 79 20 61 73 20 6d 61 6e 79 0a 20 20 20 20 20 62 79 74 65 73 20 61 73 20 ┆um), only as many bytes as ┆ 0x0820…0840 74 68 65 72 65 20 69 73 20 72 6f 6f 6d 20 66 6f 72 20 77 69 6c 6c 20 62 65 20 77 72 69 74 74 65 ┆there is room for will be writte┆ 0x0840…0860 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 20 20 20 20 20 73 75 70 70 6f 73 65 20 74 68 65 ┆n. For example, suppose the┆ 0x0860…0880 72 65 20 69 73 20 73 70 61 63 65 20 66 6f 72 20 32 30 20 62 79 74 65 73 20 6d 6f 72 65 20 69 6e ┆re is space for 20 bytes more in┆ 0x0880…08a0 20 61 20 66 69 6c 65 20 62 65 66 6f 72 65 0a 20 20 20 20 20 72 65 61 63 68 69 6e 67 20 74 68 65 ┆ a file before reaching the┆ 0x08a0…08c0 20 6c 69 6d 69 74 2e 20 41 20 77 72 69 74 65 20 6f 66 20 35 31 32 20 62 79 74 65 73 20 77 69 6c ┆ limit. A write of 512 bytes wil┆ 0x08c0…08e0 6c 20 72 65 74 75 72 6e 20 32 30 2e 0a 20 20 20 20 20 54 68 65 20 6e 65 78 74 20 77 72 69 74 65 ┆l return 20. The next write┆ 0x08e0…0900 20 6f 66 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77 ┆ of a non-zero number of bytes w┆ 0x0900…0920 69 6c 6c 20 67 69 76 65 20 61 0a 20 20 20 20 20 66 61 69 6c 75 72 65 20 72 65 74 75 72 6e 2e 0a ┆ill give a failure return. ┆ 0x0920…0940 0a 20 20 20 20 20 49 66 20 69 6e 74 65 72 72 75 70 74 65 64 20 62 79 20 61 20 73 69 67 6e 61 6c ┆ If interrupted by a signal┆ 0x0940…0960 20 62 65 66 6f 72 65 20 77 72 69 74 69 6e 67 20 61 6e 79 20 64 61 74 61 2c 20 74 68 65 0a 20 20 ┆ before writing any data, the ┆ 0x0960…0980 20 20 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 2d 31 20 77 69 74 68 ┆ functions will return -1 with┆ 0x0980…09a0 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 73 65 74 20 74 6f 20 5b 45 49 4e 54 52 5d 2e ┆ _ e_ r_ r_ n_ o set to [EINTR].┆ 0x09a0…09c0 20 49 66 0a 20 20 20 20 20 69 6e 74 65 72 72 75 70 74 65 64 20 62 79 20 61 20 73 69 67 6e 61 6c ┆ If interrupted by a signal┆ 0x09c0…09e0 20 61 66 74 65 72 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 77 72 69 74 69 6e 67 20 73 6f 6d 65 ┆ after successfully writing some┆ 0x09e0…0a00 20 64 61 74 61 0a 20 20 20 20 20 69 74 20 77 69 6c 6c 20 61 6c 73 6f 20 72 65 74 75 72 6e 20 2d ┆ data it will also return -┆ 0x0a00…0a20 31 20 61 6e 64 20 73 65 74 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 74 6f 20 5b 45 49 ┆1 and set _ e_ r_ r_ n_ o to [EI┆ 0x0a20…0a40 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 20 ┆NTR]. f f f fd d d d Is ┆ 0x0a40…0a60 74 68 65 20 6f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 6f 72 20 74 68 65 ┆the open file descriptor for the┆ 0x0a60…0a80 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 72 65 63 65 69 76 ┆ file object to receiv┆ 0x0a80…0aa0 65 20 74 68 65 20 64 61 74 61 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6c 61 67 20 ┆e the data. The following flag ┆ 0x0aa0…0ac0 61 72 67 75 6d 65 6e 74 73 20 6d 61 79 20 62 65 0a 20 20 20 20 20 20 20 20 20 20 5f 08 6f 5f 08 ┆arguments may be _ o_ ┆ 0x0ac0…0ae0 72 65 64 20 28 20 7c 20 29 20 77 69 74 68 20 74 68 65 20 6c 65 66 74 6d 6f 73 74 20 31 36 20 62 ┆red ( | ) with the leftmost 16 b┆ 0x0ae0…0b00 69 74 73 20 6f 66 20 74 68 65 20 5f 08 66 5f 08 64 20 61 72 67 75 2d 0a 20 20 20 20 20 20 20 20 ┆its of the _ f_ d argu- ┆ 0x0b00…0b20 20 20 6d 65 6e 74 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 49 4f 5f 4d 42 4c 4f 43 4b 0a 20 20 20 ┆ ment: IO_MBLOCK ┆ 0x0b20…0b40 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 73 20 6f 6e 6c 79 20 74 6f 20 64 69 73 6b ┆ Applies only to disk┆ 0x0b40…0b60 20 66 69 6c 65 73 20 74 68 61 74 20 61 72 65 20 5f 08 6e 5f 08 6f 5f 08 74 20 6f 70 65 6e 65 64 ┆ files that are _ n_ o_ t opened┆ 0x0b60…0b80 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 20 74 68 65 20 4f 5f 43 4f 4e 54 52 ┆ with the O_CONTR┆ 0x0b80…0ba0 4f 4c 20 66 6c 61 67 20 73 65 74 2e 20 49 66 20 74 68 65 20 49 4f 5f 4d 42 4c 4f 43 4b 20 66 6c ┆OL flag set. If the IO_MBLOCK fl┆ 0x0ba0…0bc0 61 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 73 20 73 65 74 2c 20 74 68 65 20 5f 08 ┆ag is set, the _ ┆ 0x0bc0…0be0 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 63 61 75 73 65 73 20 73 68 61 72 65 64 20 62 6c 6f 63 ┆w_ r_ i_ t_ e causes shared bloc┆ 0x0be0…0c00 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 ┆ 0x0c00…0c20 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┆ 0x0c20…0c40 20 74 68 65 20 77 72 69 74 65 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 50 72 6f 63 ┆ the write. (Proc┆ 0x0c40…0c60 65 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 65 ┆esses in a transaction acquire e┆ 0x0c60…0c80 78 63 6c 75 73 69 76 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 6c 6f 63 6b 2d 6c 65 ┆xclusive block-le┆ 0x0c80…0ca0 76 65 6c 20 6c 6f 63 6b 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 20 20 41 20 73 68 61 72 ┆vel locks automatically. A shar┆ 0x0ca0…0cc0 65 64 20 6c 6f 63 6b 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 65 61 6b 65 72 ┆ed lock is weaker┆ 0x0cc0…0ce0 20 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 69 67 6e 6f 72 65 64 2e 29 20 54 68 65 20 6c 6f 63 ┆ and therefore ignored.) The loc┆ 0x0ce0…0d00 6b 20 6d 75 73 74 20 62 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6d 6f 76 65 64 ┆k must be removed┆ 0x0d00…0d20 20 6d 61 6e 75 61 6c 6c 79 20 75 73 69 6e 67 20 74 68 65 20 5f 08 6d 5f 08 62 5f 08 6c 5f 08 6f ┆ manually using the _ m_ b_ l_ o┆ 0x0d20…0d40 5f 08 63 5f 08 6b 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 ┆_ c_ k system call. ┆ 0x0d40…0d60 20 20 20 54 68 65 20 49 4f 5f 4d 42 4c 4f 43 4b 20 66 6c 61 67 20 69 73 20 6d 61 70 70 65 64 20 ┆ The IO_MBLOCK flag is mapped ┆ 0x0d60…0d80 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 4f 5f ┆internally to IO_┆ 0x0d80…0da0 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 48 0a 0a ┆MBLOCKS. IO_MBLOCKH ┆ 0x0da0…0dc0 0a 0a 0a 0a 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 79 ┆ Applies only┆ 0x0dc0…0de0 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 08 ┆ to disk files that are _ n_ o_ ┆ 0x0de0…0e00 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 65 ┆t opened with the┆ 0x0e00…0e20 20 4f 5f 43 4f 4e 54 52 4f 4c 20 66 6c 61 67 20 73 65 74 2e 20 49 66 20 74 68 65 20 49 4f 5f 4d ┆ O_CONTROL flag set. If the IO_M┆ 0x0e20…0e40 42 4c 4f 43 4b 48 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 20 69 73 20 73 65 ┆BLOCKH flag is se┆ 0x0e40…0e60 74 2c 20 74 68 65 20 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 61 70 70 6c 69 65 73 20 61 ┆t, the _ w_ r_ i_ t_ e applies a┆ 0x0e60…0e80 20 60 60 68 6f 6c 64 27 27 20 6c 6f 63 6b 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ ``hold'' lock to ┆ 0x0e80…0ea0 20 65 61 63 68 20 62 6c 6f 63 6b 20 61 63 63 65 73 73 65 64 20 62 79 20 74 68 65 20 77 72 69 74 ┆ each block accessed by the writ┆ 0x0ea0…0ec0 65 20 6f 70 65 72 61 74 69 6f 6e 2e 20 54 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆e operation. The ┆ 0x0ec0…0ee0 6c 6f 63 6b 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 75 73 ┆lock must be manually removed us┆ 0x0ee0…0f00 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 0a 20 20 20 20 20 ┆ing the _ m_ b_ l_ o_ c_ k ┆ 0x0f00…0f20 20 20 20 20 20 20 20 20 20 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 20 20 41 20 68 6f 6c 64 20 6c ┆ system call. A hold l┆ 0x0f20…0f40 6f 63 6b 20 69 73 20 73 74 72 6f 6e 67 65 72 20 74 68 61 6e 20 61 0a 20 20 20 20 20 20 20 20 20 ┆ock is stronger than a ┆ 0x0f40…0f60 20 20 20 20 20 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 ┆ shared lock, weaker than a┆ 0x0f60…0f80 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 ┆n exclusive lock, and ┆ 0x0f80…0fa0 20 20 20 20 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 ┆ incompatible with itself. T┆ 0x0fa0…0fc0 68 65 20 66 6c 61 67 20 61 72 67 75 6d 65 6e 74 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 ┆he flag argument is ┆ 0x0fc0…0fe0 20 20 20 69 67 6e 6f 72 65 64 20 69 6e 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f ┆ ignored inside transaction mo┆ 0x0fe0…1000 64 65 20 62 65 63 61 75 73 65 20 74 68 65 20 68 6f 6c 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 ┆de because the hold ┆ 0x1000…1020 20 20 20 6c 6f 63 6b 20 69 73 20 77 65 61 6b 65 72 20 74 68 61 6e 20 74 68 65 20 61 75 74 6f 6d ┆ lock is weaker than the autom┆ 0x1020…1040 61 74 69 63 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 ┆atic exclusive lock. ┆ 0x1040…1060 49 4f 5f 4d 42 4c 4f 43 4b 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 ┆IO_MBLOCKS Applie┆ 0x1060…1080 73 20 6f 6e 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 ┆s only to disk files that are _ ┆ 0x1080…10a0 6e 5f 08 6f 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 ┆n_ o_ t opened wi┆ 0x10a0…10c0 74 68 20 74 68 65 20 4f 5f 43 4f 4e 54 52 4f 4c 20 66 6c 61 67 20 73 65 74 2e 20 49 66 20 74 68 ┆th the O_CONTROL flag set. If th┆ 0x10c0…10e0 65 20 49 4f 5f 4d 42 4c 4f 43 4b 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 ┆e IO_MBLOCKS flag┆ 0x10e0…1100 20 69 73 20 73 65 74 2c 20 74 68 65 20 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 61 70 70 ┆ is set, the _ w_ r_ i_ t_ e app┆ 0x1100…1120 6c 69 65 73 20 73 68 61 72 65 64 20 62 6c 6f 63 6b 2d 6c 65 76 65 6c 0a 20 20 20 20 20 20 20 20 ┆lies shared block-level ┆ 0x1120…1140 20 20 20 20 20 20 20 6c 6f 63 6b 73 20 74 6f 20 65 61 63 68 20 62 6c 6f 63 6b 20 61 63 63 65 73 ┆ locks to each block acces┆ 0x1140…1160 73 65 64 20 62 79 20 74 68 65 20 77 72 69 74 65 20 6f 70 65 72 61 2d 0a 20 20 20 20 20 20 20 20 ┆sed by the write opera- ┆ 0x1160…1180 20 20 20 20 20 20 20 74 69 6f 6e 2e 20 20 54 68 65 20 66 6c 61 67 20 69 73 20 69 67 6e 6f 72 65 ┆ tion. The flag is ignore┆ 0x1180…11a0 64 20 69 6e 73 69 64 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 73 0a 20 20 20 20 20 20 20 ┆d inside transactions as ┆ 0x11a0…11c0 20 20 20 20 20 20 20 20 73 74 72 6f 6e 67 65 72 20 65 78 63 6c 75 73 69 76 65 20 62 6c 6f 63 6b ┆ stronger exclusive block┆ 0x11c0…11e0 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 0a 20 20 20 20 20 20 ┆-level locks are acquired ┆ 0x11e0…1200 20 20 20 20 20 20 20 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 6e 20 77 72 69 74 69 6e ┆ automatically on writin┆ 0x1200…1220 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 20 20 20 20 20 20 ┆g. IO_MBLOCKX ┆ 0x1220…1240 20 20 20 20 20 20 20 20 41 70 70 6c 69 65 73 20 6f 6e 6c 79 20 74 6f 20 64 69 73 6b 20 66 69 6c ┆ Applies only to disk fil┆ 0x1240…1260 65 73 20 74 68 61 74 20 61 72 65 20 5f 08 6e 5f 08 6f 5f 08 74 20 6f 70 65 6e 65 64 0a 20 20 20 ┆es that are _ n_ o_ t opened ┆ 0x1260…1280 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 20 74 68 65 20 4f 5f 43 4f 4e 54 52 4f 4c 20 66 ┆ with the O_CONTROL f┆ 0x1280…12a0 6c 61 67 20 73 65 74 2e 20 49 66 20 74 68 65 20 49 4f 5f 4d 42 4c 4f 43 4b 58 0a 20 20 20 20 20 ┆lag set. If the IO_MBLOCKX ┆ 0x12a0…12c0 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 65 20 5f 08 77 5f 08 ┆ flag is set, the _ w_ ┆ 0x12c0…12e0 72 5f 08 69 5f 08 74 5f 08 65 20 61 70 70 6c 69 65 73 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 ┆r_ i_ t_ e applies an exclusive ┆ 0x12e0…1300 6c 6f 63 6b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 65 61 63 68 20 62 6c 6f 63 ┆lock to each bloc┆ 0x1300…1320 6b 20 61 63 63 65 73 73 65 64 20 62 79 20 74 68 65 20 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f ┆k accessed by the write operatio┆ 0x1320…1340 6e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 65 20 6c 6f 63 6b 20 6d 75 73 74 20 ┆n. The lock must ┆ 0x1340…1360 62 65 20 72 65 6d 6f 76 65 64 20 6d 61 6e 75 61 6c 6c 79 20 75 73 69 6e 67 20 74 68 65 20 5f 08 ┆be removed manually using the _ ┆ 0x1360…1380 6d 5f 08 62 5f 08 6c 5f 08 6f 5f 08 63 5f 08 6b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆m_ b_ l_ o_ c_ k ┆ 0x1380…13a0 73 79 73 74 65 6d 20 63 61 6c 6c 2e 20 20 49 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 ┆system call. In transaction mod┆ 0x13a0…13c0 65 20 74 68 65 20 66 6c 61 67 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 67 6e ┆e the flag is ign┆ 0x13c0…13e0 6f 72 65 64 20 62 65 63 61 75 73 65 20 65 78 63 6c 75 73 69 76 65 20 62 6c 6f 63 6b 2d 6c 65 76 ┆ored because exclusive block-lev┆ 0x13e0…1400 65 6c 20 6c 6f 63 6b 73 20 61 72 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 62 74 61 ┆el locks are obta┆ 0x1400…1420 69 6e 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 ┆ined automatically. I┆ 0x1420…1440 4f 5f 4d 58 49 50 43 49 4e 56 49 54 45 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 ┆O_MXIPCINVITE App┆ 0x1440…1460 65 6e 64 73 20 61 6e 20 60 60 69 6e 76 69 74 61 74 69 6f 6e 20 74 6f 20 6a 6f 69 6e 27 27 20 69 ┆ends an ``invitation to join'' i┆ 0x1460…1480 6e 64 69 63 61 74 69 6f 6e 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 ┆ndication to the ┆ 0x1480…14a0 77 72 69 74 74 65 6e 20 6d 65 73 73 61 67 65 20 65 78 70 6c 69 63 69 74 6c 79 2e 20 20 54 68 65 ┆written message explicitly. The┆ 0x14a0…14c0 20 72 65 61 64 65 72 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 20 6d ┆ reader of this m┆ 0x14c0…14e0 65 73 73 61 67 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6a 6f 69 6e 20 74 ┆essage will automatically join t┆ 0x14e0…1500 68 65 20 74 72 61 6e 73 61 63 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 69 6f 6e 2e ┆he transac- tion.┆ 0x1500…1520 20 4e 6f 72 6d 61 6c 6c 79 2c 20 74 68 65 20 60 60 69 6e 76 69 74 61 74 69 6f 6e 20 74 6f 20 6a ┆ Normally, the ``invitation to j┆ 0x1520…1540 6f 69 6e 27 27 20 69 6e 64 69 63 61 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 69 6f ┆oin'' indica- tio┆ 0x1540…1560 6e 20 69 73 20 61 70 70 65 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 6f 20 74 ┆n is appended automatically to t┆ 0x1560…1580 68 65 20 66 69 72 73 74 20 6d 65 73 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 61 67 ┆he first mes- sag┆ 0x1580…15a0 65 20 77 72 69 74 74 65 6e 20 74 6f 20 61 6e 20 4d 58 49 50 43 20 63 68 61 6e 6e 65 6c 20 61 66 ┆e written to an MXIPC channel af┆ 0x15a0…15c0 74 65 72 20 74 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 62 ┆ter transaction b┆ 0x15c0…15e0 65 67 69 6e 2e 20 20 54 68 69 73 20 66 6c 61 67 20 65 6e 66 6f 72 63 65 73 20 74 68 65 20 69 6e ┆egin. This flag enforces the in┆ 0x15e0…1600 76 69 74 61 74 69 6f 6e 2e 20 20 49 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f ┆vitation. It pro┆ 0x1600…1620 76 69 64 65 73 20 61 20 77 61 79 20 74 6f 20 62 72 69 6e 67 20 61 20 73 65 72 76 65 72 20 70 72 ┆vides a way to bring a server pr┆ 0x1620…1640 6f 63 65 73 73 20 62 61 63 6b 20 69 6e 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 ┆ocess back into t┆ 0x1640…1660 68 65 20 73 61 6d 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 ┆he same transaction. ┆ 0x1660…1680 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 65 63 69 66 69 ┆IO_NBLOCK Specifi┆ 0x1680…16a0 65 73 20 74 68 61 74 20 74 68 69 73 20 77 72 69 74 65 20 69 73 20 74 6f 20 62 65 20 6e 6f 6e 2d ┆es that this write is to be non-┆ 0x16a0…16c0 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 64 6c ┆blocking, regardl┆ 0x16c0…16e0 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 49 2f ┆ess of the default action for I/┆ 0x16e0…1700 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 69 70 ┆O on this descrip┆ 0x1700…1720 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 77 6f ┆tor. If a blocking condition wo┆ 0x1720…1740 75 6c 64 20 6f 63 63 75 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5f 08 77 5f 08 72 ┆uld occur, _ w_ r┆ 0x1740…1760 5f 08 69 5f 08 74 5f 08 65 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 2e 0a 0a 20 20 20 ┆_ i_ t_ e returns an error. ┆ 0x1760…1780 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 ┆ 0x1780…17a0 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 2e 20 20 5f 08 ┆Generate SIGERR and SIGPIPE. _ ┆ 0x17a0…17c0 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20 20 20 20 20 20 ┆w_ r_ i_ t_ e does not ┆ 0x17c0…17e0 20 20 20 20 20 20 72 65 74 75 72 6e 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 ┆ return the appropriate err┆ 0x17e0…1800 6f 72 20 63 6f 64 65 2c 20 62 75 74 20 67 65 6e 65 72 61 74 65 73 0a 20 20 20 20 20 20 20 20 20 ┆or code, but generates ┆ 0x1800…1820 20 20 20 20 20 20 74 68 65 20 73 69 67 6e 61 6c 73 20 69 6e 73 74 65 61 64 2e 0a 0a 20 20 20 20 ┆ the signals instead. ┆ 0x1820…1840 20 20 20 20 20 20 49 4f 5f 4e 4f 53 49 47 41 42 4f 52 54 0a 20 20 20 20 20 20 20 20 20 20 20 20 ┆ IO_NOSIGABORT ┆ 0x1840…1860 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 61 74 20 74 68 65 20 53 49 47 41 42 4f 52 54 20 73 ┆ Specifies that the SIGABORT s┆ 0x1860…1880 69 67 6e 61 6c 20 69 73 20 6e 6f 74 20 74 6f 20 62 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ignal is not to be ┆ 0x1880…18a0 20 20 67 65 6e 65 72 61 74 65 64 2e 20 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 ┆ generated. If a transaction a┆ 0x18a0…18c0 62 6f 72 74 20 64 6f 65 73 20 6f 63 63 75 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆bort does occur, ┆ 0x18c0…18e0 5f 08 72 5f 08 65 5f 08 61 5f 08 64 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 61 6e ┆_ r_ e_ a_ d returns an error an┆ 0x18e0…1900 64 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 69 6e ┆d _ e_ r_ r_ n_ o contains an in┆ 0x1900…1920 64 69 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 74 69 6f 6e 20 6f 66 20 74 68 65 ┆di- cation of the┆ […truncated at 200 lines…]