DataMuseum.dk

top - download

    Length: 4424 (0x1148)
    Names: »lseek.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat2/lseek.2« 

Default Hex Dump

0x0000…0020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x0020…0040 08 75 5f 08 61 5f 08 6c 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 6c 73 65 65 6b 28 32 29 0a 0a 0a 0a   ┆s                   lseek(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 6c 73 65 65 6b 20 2d 20 6d 6f 76 65 20 72 65 61 64 2f 77 72 69 74 65 20 70 6f 69 6e 74 65   ┆  lseek - move read/write pointe┆
0x00a0…00c0 72 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   ┆r  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 23 08 23 08 23 08 23 69 08 69 08 69 08   ┆ A A AX X X X      # # # #i i i ┆
0x00e0…0100 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 75 64 08 64   ┆in n n nc c c cl l l lu u u ud d┆
0x0100…0120 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 79 08 79 08   ┆ d de e e e < < < <s s s sy y y ┆
0x0120…0140 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 79 70 08 70   ┆ys s s s/ / / /t t t ty y y yp p┆
0x0140…0160 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 08 68 08 68   ┆ p pe e e es s s s. . . .h h h h┆
0x0160…0180 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 08 6e 08 6e   ┆> > > >      # # # #i i i in n n┆
0x0180…01a0 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 08 64 65 08   ┆ nc c c cl l l lu u u ud d d de ┆
0x01a0…01c0 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 75 08 75 08 75 08 75 6e 08 6e 08 6e 08 6e 69 08 69 08 69   ┆e e e < < < <u u u un n n ni i i┆
0x01c0…01e0 08 69 73 08 73 08 73 08 73 74 08 74 08 74 08 74 64 08 64 08 64 08 64 2e 08 2e 08 2e 08 2e 68 08   ┆ is s s st t t td d d d. . . .h ┆
0x01e0…0200 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08   ┆h h h> > > >       o o o of f f ┆
0x0200…0220 66 66 08 66 08 66 08 66 5f 08 5f 08 5f 08 5f 74 08 74 08 74 08 74 20 6c 08 6c 08 6c 08 6c 73 08   ┆ff f f f_ _ _ _t t t t l l l ls ┆
0x0220…0240 73 08 73 08 73 65 08 65 08 65 08 65 65 08 65 08 65 08 65 6b 08 6b 08 6b 08 6b 28 08 28 08 28 08   ┆s s se e e ee e e ek k k k( ( ( ┆
0x0240…0260 28 66 08 66 08 66 08 66 69 08 69 08 69 08 69 6c 08 6c 08 6c 08 6c 64 08 64 08 64 08 64 65 08 65   ┆(f f f fi i i il l l ld d d de e┆
0x0260…0280 08 65 08 65 73 08 73 08 73 08 73 2c 08 2c 08 2c 08 2c 20 6f 08 6f 08 6f 08 6f 66 08 66 08 66 08   ┆ e es s s s, , , , o o o of f f ┆
0x0280…02a0 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, ,┆
0x02a0…02c0 08 2c 08 2c 20 77 08 77 08 77 08 77 68 08 68 08 68 08 68 65 08 65 08 65 08 65 6e 08 6e 08 6e 08   ┆ , , w w w wh h h he e e en n n ┆
0x02c0…02e0 6e 63 08 63 08 63 08 63 65 08 65 08 65 08 65 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08   ┆nc c c ce e e e) ) ) )      i i ┆
0x02e0…0300 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 66 08 66 08 66 08 66 69 08 69 08 69 08 69   ┆i in n n nt t t t f f f fi i i i┆
0x0300…0320 6c 08 6c 08 6c 08 6c 64 08 64 08 64 08 64 65 08 65 08 65 08 65 73 08 73 08 73 08 73 2c 08 2c 08   ┆l l l ld d d de e e es s s s, , ┆
0x0320…0340 2c 08 2c 20 77 08 77 08 77 08 77 68 08 68 08 68 08 68 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e   ┆, , w w w wh h h he e e en n n n┆
0x0340…0360 63 08 63 08 63 08 63 65 08 65 08 65 08 65 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 6f 08 6f 08 6f   ┆c c c ce e e e; ; ; ;      o o o┆
0x0360…0380 08 6f 66 08 66 08 66 08 66 66 08 66 08 66 08 66 5f 08 5f 08 5f 08 5f 74 08 74 08 74 08 74 20 6f   ┆ of f f ff f f f_ _ _ _t t t t o┆
0x0380…03a0 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 08 65   ┆ o o of f f ff f f fs s s se e e┆
0x03a0…03c0 08 65 74 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   ┆ et t t t; ; ; ;  D D D DE E E E┆
0x03c0…03e0 53 08 53 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   ┆S S S SC C C CR R R RI I I IP P ┆
0x03e0…0400 50 08 50 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   ┆P PT T T TI I I IO O O ON N N N ┆
0x0400…0420 20 20 20 20 20 54 68 65 20 64 65 73 63 72 69 70 74 6f 72 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64   ┆     The descriptor _ f_ i_ l_ d┆
0x0420…0440 5f 08 65 5f 08 73 20 72 65 66 65 72 73 20 74 6f 20 61 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 6f   ┆_ e_ s refers to a file object o┆
0x0440…0460 70 65 6e 20 66 6f 72 20 72 65 61 64 2d 0a 20 20 20 20 20 69 6e 67 20 61 6e 64 2f 6f 72 20 77 72   ┆pen for read-      ing and/or wr┆
0x0460…0480 69 74 69 6e 67 2e 20 20 5f 08 6c 5f 08 73 5f 08 65 5f 08 65 5f 08 6b 20 73 65 74 73 20 74 68 65   ┆iting.  _ l_ s_ e_ e_ k sets the┆
0x0480…04a0 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 6f 66 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65   ┆ file pointer of _ f_ i_ l_ d_ e┆
0x04a0…04c0 5f 08 73 0a 20 20 20 20 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 20 20 20 20 20 20 20 20   ┆_ s      as follows:            ┆
0x04c0…04e0 49 66 20 5f 08 77 5f 08 68 5f 08 65 5f 08 6e 5f 08 63 5f 08 65 20 69 73 20 53 45 45 4b 5f 53 45   ┆If _ w_ h_ e_ n_ c_ e is SEEK_SE┆
0x04e0…0500 54 2c 20 74 68 65 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 69 73 20 73 65 74 20 74 6f 0a 20 20   ┆T, the file pointer is set to   ┆
0x0500…0520 20 20 20 20 20 20 20 20 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 20 62 79 74 65 73   ┆        _ o_ f_ f_ s_ e_ t bytes┆
0x0520…0540 2e 20 20 49 66 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 20 72 65 66 65 72 73 20   ┆.  If _ f_ i_ l_ d_ e_ s refers ┆
0x0540…0560 74 6f 20 61 6e 20 4d 58 49 50 43 20 63 68 61 6e 6e 65 6c 2c 0a 20 20 20 20 20 20 20 20 20 20 5f   ┆to an MXIPC channel,           _┆
0x0560…0580 08 77 5f 08 68 5f 08 65 5f 08 6e 5f 08 63 5f 08 65 20 6d 75 73 74 20 62 65 20 73 65 74 20 74 6f   ┆ w_ h_ e_ n_ c_ e must be set to┆
0x0580…05a0 20 53 45 45 4b 5f 53 45 54 20 61 6e 64 20 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74   ┆ SEEK_SET and _ o_ f_ f_ s_ e_ t┆
0x05a0…05c0 20 73 70 65 63 69 66 69 65 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 6d 65 73 73 61 67 65   ┆ specifies the           message┆
0x05c0…05e0 20 74 79 70 65 20 66 6f 72 20 74 68 65 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 2e 0a 0a 20 20 20   ┆ type for the file pointer.     ┆
0x05e0…0600 20 20 20 20 20 20 20 49 66 20 5f 08 77 5f 08 68 5f 08 65 5f 08 6e 5f 08 63 5f 08 65 20 69 73 20   ┆       If _ w_ h_ e_ n_ c_ e is ┆
0x0600…0620 53 45 45 4b 5f 43 55 52 2c 20 74 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 73 65 74 20 74 6f 20   ┆SEEK_CUR, the pointer is set to ┆
0x0620…0640 69 74 73 0a 20 20 20 20 20 20 20 20 20 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 70   ┆its           current location p┆
0x0640…0660 6c 75 73 20 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 2e 0a 0a 20 20 20 20 20 20 20   ┆lus _ o_ f_ f_ s_ e_ t.         ┆
0x0660…0680 20 20 20 49 66 20 5f 08 77 5f 08 68 5f 08 65 5f 08 6e 5f 08 63 5f 08 65 20 69 73 20 53 45 45 4b   ┆   If _ w_ h_ e_ n_ c_ e is SEEK┆
0x0680…06a0 5f 45 4e 44 2c 20 74 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20   ┆_END, the pointer is set to the ┆
0x06a0…06c0 73 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 66 69 6c 65 20 70 6c 75 73 20   ┆size           of the file plus ┆
0x06c0…06e0 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 2e 0a 0a 20 20 20 20 20 54 68 65 20 73 79   ┆_ o_ f_ f_ s_ e_ t.       The sy┆
0x06e0…0700 6d 62 6f 6c 69 63 20 63 6f 6e 74 61 6e 74 73 20 53 45 45 4b 5f 53 45 54 2c 20 53 45 45 4b 5f 43   ┆mbolic contants SEEK_SET, SEEK_C┆
0x0700…0720 55 52 20 61 6e 64 20 53 45 45 4b 5f 45 4e 44 20 61 72 65 0a 20 20 20 20 20 64 65 66 69 6e 65 64   ┆UR and SEEK_END are      defined┆
0x0720…0740 20 69 6e 20 74 68 65 20 3c 08 3c 08 3c 08 3c 75 08 75 08 75 08 75 6e 08 6e 08 6e 08 6e 69 08 69   ┆ in the < < < <u u u un n n ni i┆
0x0740…0760 08 69 08 69 73 08 73 08 73 08 73 74 08 74 08 74 08 74 64 08 64 08 64 08 64 2e 08 2e 08 2e 08 2e   ┆ i is s s st t t td d d d. . . .┆
0x0760…0780 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 20 68 65 61 64 65 72 20 66 69 6c 65 2e 0a 0a 20 20 20   ┆h h h h> > > > header file.     ┆
0x0780…07a0 20 20 55 70 6f 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   ┆  Upon successful completion, th┆
0x07a0…07c0 65 20 72 65 73 75 6c 74 69 6e 67 20 70 6f 69 6e 74 65 72 20 6c 6f 63 61 74 69 6f 6e 0a 20 20 20   ┆e resulting pointer location    ┆
0x07c0…07e0 20 20 61 73 20 6d 65 61 73 75 72 65 64 20 69 6e 20 62 79 74 65 73 20 66 72 6f 6d 20 62 65 67 69   ┆  as measured in bytes from begi┆
0x07e0…0800 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 20   ┆nning of the file is returned.  ┆
0x0800…0820 20 20 20 20 53 6f 6d 65 20 64 65 76 69 63 65 73 20 61 72 65 20 69 6e 63 61 70 61 62 6c 65 20 6f   ┆    Some devices are incapable o┆
0x0820…0840 66 20 73 65 65 6b 69 6e 67 2e 20 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 0a 20 20 20   ┆f seeking.  The value of the    ┆
0x0840…0860 20 20 70 6f 69 6e 74 65 72 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 73 75 63 68 20 61   ┆  pointer associated with such a┆
0x0860…0880 20 64 65 76 69 63 65 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 0a 0a 20 20 20 20 20 46 69 6c 65   ┆ device is undefined.       File┆
0x0880…08a0 73 20 6f 70 65 6e 65 64 20 77 69 74 68 20 74 68 65 20 4f 5f 41 50 50 45 4e 44 20 66 6c 61 67 20   ┆s opened with the O_APPEND flag ┆
0x08a0…08c0 73 65 74 2c 20 61 6c 77 61 79 73 20 77 72 69 74 65 20 64 61 74 61 0a 20 20 20 20 20 74 6f 20 74   ┆set, always write data      to t┆
0x08c0…08e0 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 3b 20 68 6f 77 65 76 65 72 2c 20 5f 08 6c   ┆he end of the file; however, _ l┆
0x08e0…0900 5f 08 73 5f 08 65 5f 08 65 5f 08 6b 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 70 6f 73 69   ┆_ s_ e_ e_ k can be used to posi┆
0x0900…0920 2d 0a 20 20 20 20 20 74 69 6f 6e 20 74 68 65 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 66 6f 72   ┆-      tion the file pointer for┆
0x0920…0940 20 72 65 61 64 69 6e 67 2e 0a 0a 20 20 20 20 20 55 70 6f 6e 20 73 75 63 63 65 73 73 66 75 6c 20   ┆ reading.       Upon successful ┆
0x0940…0960 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 6e 20 61 6e 20 4d 58 49 50 43 20 66 69 6c 65 2c 20 74 68 65   ┆completion on an MXIPC file, the┆
0x0960…0980 20 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 0a 20 20 20 20 20 73 70 65 63 69 66 69   ┆ _ o_ f_ f_ s_ e_ t      specifi┆
0x0980…09a0 65 73 20 74 68 65 20 6d 65 73 73 61 67 65 20 74 79 70 65 20 74 6f 20 62 65 20 72 65 61 64 20 6f   ┆es the message type to be read o┆
0x09a0…09c0 72 20 77 72 69 74 74 65 6e 2e 20 20 41 20 30 20 69 6e 64 69 2d 0a 20 20 20 20 20 63 61 74 65 73   ┆r written.  A 0 indi-      cates┆
0x09c0…09e0 20 74 68 61 74 20 61 6e 79 20 6d 65 73 73 61 67 65 20 74 79 70 65 20 63 61 6e 20 62 65 20 72 65   ┆ that any message type can be re┆
0x09e0…0a00 61 64 2c 20 61 6e 64 20 61 20 6e 65 67 61 74 69 76 65 0a 20 20 20 20 20 5f 08 6f 5f 08 66 5f 08   ┆ad, and a negative      _ o_ f_ ┆
0x0a00…0a20 66 5f 08 73 5f 08 65 5f 08 74 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 61 6c 6c 20 6d 65   ┆f_ s_ e_ t indicates that all me┆
0x0a20…0a40 73 73 61 67 65 20 74 79 70 65 73 20 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 74 68 65 0a 20 20   ┆ssage types between 0 and the   ┆
0x0a40…0a60 20 20 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 70 65 63 69 66 69   ┆   absolute value of the specifi┆
0x0a60…0a80 65 64 20 6f 66 66 73 65 74 20 63 61 6e 20 62 65 20 72 65 61 64 2e 20 20 41 20 6e 65 67 61 2d 0a   ┆ed offset can be read.  A nega- ┆
0x0a80…0aa0 20 20 20 20 20 74 69 76 65 20 6d 65 73 73 61 67 65 20 74 79 70 65 20 6f 6e 20 61 20 77 72 69 74   ┆     tive message type on a writ┆
0x0aa0…0ac0 65 20 69 73 20 74 72 65 61 74 65 64 20 61 73 20 6d 65 73 73 61 67 65 20 74 79 70 65 20 30 2e 0a   ┆e is treated as message type 0. ┆
0x0ac0…0ae0 0a 20 20 20 20 20 53 65 65 6b 69 6e 67 20 66 61 72 20 62 65 79 6f 6e 64 20 74 68 65 20 65 6e 64   ┆      Seeking far beyond the end┆
0x0ae0…0b00 20 6f 66 20 61 20 66 69 6c 65 20 61 6e 64 20 74 68 65 6e 20 77 72 69 74 69 6e 67 20 63 61 75 73   ┆ of a file and then writing caus┆
0x0b00…0b20 65 73 0a 20 20 20 20 20 63 72 65 61 74 69 6f 6e 20 6f 66 20 61 20 67 61 70 20 6f 72 20 22 68 6f   ┆es      creation of a gap or "ho┆
0x0b20…0b40 6c 65 22 20 28 77 68 69 63 68 20 6f 63 63 75 70 69 65 73 20 6e 6f 20 70 68 79 73 69 63 61 6c 0a   ┆le" (which occupies no physical ┆
0x0b40…0b60 20 20 20 20 20 73 70 61 63 65 20 61 6e 64 20 72 65 61 64 73 20 61 73 20 30 73 29 2e 0a 0a 20 20   ┆     space and reads as 0s).    ┆
0x0b60…0b80 20 20 20 54 08 54 08 54 08 54 72 08 72 08 72 08 72 61 08 61 08 61 08 61 6e 08 6e 08 6e 08 6e 73   ┆   T T T Tr r r ra a a an n n ns┆
0x0b80…0ba0 08 73 08 73 08 73 61 08 61 08 61 08 61 63 08 63 08 63 08 63 74 08 74 08 74 08 74 69 08 69 08 69   ┆ s s sa a a ac c c ct t t ti i i┆
0x0ba0…0bc0 08 69 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 73 08 73 08 73 08 73 0a 20 20 20 20 20 49 66 20   ┆ io o o on n n ns s s s      If ┆
0x0bc0…0be0 61 20 70 72 6f 63 65 73 73 20 69 73 73 75 65 73 20 5f 08 6c 5f 08 73 5f 08 65 5f 08 65 5f 08 6b   ┆a process issues _ l_ s_ e_ e_ k┆
0x0be0…0c00 20 77 68 69 6c 65 20 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 20 61 6e 64 20 74   ┆ while in transaction mode and t┆
0x0c00…0c20 68 65 6e 0a 20 20 20 20 20 69 73 73 75 65 73 20 74 68 65 20 5f 08 74 5f 08 72 5f 08 61 5f 08 6e   ┆hen      issues the _ t_ r_ a_ n┆
0x0c20…0c40 5f 08 73 28 54 52 5f 41 42 4f 52 54 2c 20 30 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2c 20 74 68   ┆_ s(TR_ABORT, 0) system call, th┆
0x0c40…0c60 65 20 70 72 6f 63 65 73 73 0a 20 20 20 20 20 61 62 6f 72 74 73 20 77 69 74 68 20 74 68 65 20 6f   ┆e process      aborts with the o┆
0x0c60…0c80 66 66 73 65 74 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 74 73 20 76 61 6c 75 65 20 61 74 20 74   ┆ffset restored to its value at t┆
0x0c80…0ca0 68 65 20 62 65 67 69 6e 2d 0a 20 20 20 20 20 6e 69 6e 67 20 6f 66 20 74 68 65 20 74 72 61 6e 73   ┆he begin-      ning of the trans┆
0x0ca0…0cc0 61 63 74 69 6f 6e 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45 54 08 54 08 54 08 54 55 08   ┆action.  R R R RE E E ET T T TU ┆
0x0cc0…0ce0 55 08 55 08 55 52 08 52 08 52 08 52 4e 08 4e 08 4e 08 4e 20 56 08 56 08 56 08 56 41 08 41 08 41   ┆U U UR R R RN N N N V V V VA A A┆
0x0ce0…0d00 08 41 4c 08 4c 08 4c 08 4c 55 08 55 08 55 08 55 45 08 45 08 45 08 45 0a 20 20 20 20 20 55 70 6f   ┆ AL L L LU U U UE E E E      Upo┆
0x0d00…0d20 6e 20 73 75 63 63 65 73 73 66 75 6c 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 74 68 65 20 63 75 72 72   ┆n successful completion the curr┆
0x0d20…0d40 65 6e 74 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 76 61 6c 75 65 20 69 73 0a 20 20 20 20 20 72   ┆ent file pointer value is      r┆
0x0d40…0d60 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61 20 76 61 6c 75 65 20 6f 66 20 2d   ┆eturned. Otherwise, a value of -┆
0x0d60…0d80 31 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08   ┆1 is returned and _ e_ r_ r_ n_ ┆
0x0d80…0da0 6f 20 69 73 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 73 65 74 20 74 6f 20 69 6e 64 69 63 61 74 65 20   ┆o is            set to indicate ┆
0x0da0…0dc0 74 68 65 20 65 72 72 6f 72 2e 0a 0a 20 20 20 20 20 41 20 2d 31 20 6d 61 79 20 62 65 20 72 65 74   ┆the error.       A -1 may be ret┆
0x0dc0…0de0 75 72 6e 65 64 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 20 65 72 72 6f 72 2c 20 69 66   ┆urned when there is no error, if┆
0x0de0…0e00 20 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 20 66 6f 72 0a 20 20 20 20 20 61 6e 20   ┆ _ o_ f_ f_ s_ e_ t for      an ┆
0x0e00…0e20 4d 58 49 50 43 20 66 69 6c 65 20 69 73 20 73 65 74 20 74 6f 20 2d 31 2e 20 20 49 66 20 2d 31 20   ┆MXIPC file is set to -1.  If -1 ┆
0x0e20…0e40 69 73 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 0a 20 20 20 20 20 5f   ┆is to be specified in the      _┆
0x0e40…0e60 08 6f 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 20 70 61 72 61 6d 65 74 65 72 2c 20 74 68 65   ┆ o_ f_ f_ s_ e_ t parameter, the┆
0x0e60…0e80 6e 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20   ┆n _ e_ r_ r_ n_ o should be set ┆
0x0e80…0ea0 74 6f 20 30 20 62 65 66 6f 72 65 20 74 68 65 0a 20 20 20 20 20 5f 08 6c 5f 08 73 5f 08 65 5f 08   ┆to 0 before the      _ l_ s_ e_ ┆
0x0ea0…0ec0 65 5f 08 6b 20 63 61 6c 6c 20 69 73 20 6d 61 64 65 2e 0a 0a 45 08 45 08 45 08 45 52 08 52 08 52   ┆e_ k call is made.  E E E ER R R┆
0x0ec0…0ee0 08 52 52 08 52 08 52 08 52 4f 08 4f 08 4f 08 4f 52 08 52 08 52 08 52 53 08 53 08 53 08 53 0a 20   ┆ RR R R RO O O OR R R RS S S S  ┆
0x0ee0…0f00 20 20 20 20 5f 08 6c 5f 08 73 5f 08 65 5f 08 65 5f 08 6b 20 66 61 69 6c 73 20 61 6e 64 20 74 68   ┆    _ l_ s_ e_ e_ k fails and th┆
0x0f00…0f20 65 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 72 65 6d 61 69 6e 73 20 75 6e 63 68 61 6e 67 65 64   ┆e file pointer remains unchanged┆
0x0f20…0f40 20 69 66 3a 0a 0a 20 20 20 20 20 5b 45 42 41 44 46 5d 20 20 20 20 20 20 20 20 5f 08 66 5f 08 69   ┆ if:       [EBADF]        _ f_ i┆
0x0f40…0f60 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 20 69 73 20 6e 6f 74 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65   ┆_ l_ d_ e_ s is not an open file┆
0x0f60…0f80 20 64 65 73 63 72 69 70 74 6f 72 2e 0a 0a 20 20 20 20 20 5b 45 53 50 49 50 45 5d 20 20 20 20 20   ┆ descriptor.       [ESPIPE]     ┆
0x0f80…0fa0 20 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 20 69 73 20 61 73 73 6f 63 69 61 74   ┆  _ f_ i_ l_ d_ e_ s is associat┆
0x0fa0…0fc0 65 64 20 77 69 74 68 20 61 20 70 69 70 65 20 6f 72 20 61 20 73 6f 63 6b 65 74 2e 0a 0a 20 20 20   ┆ed with a pipe or a socket.     ┆
0x0fc0…0fe0 20 20 5b 45 49 4e 56 41 4c 5d 20 20 20 20 20 20 20 45 69 74 68 65 72 20 5f 08 77 5f 08 68 5f 08   ┆  [EINVAL]       Either _ w_ h_ ┆
0x0fe0…1000 65 5f 08 6e 5f 08 63 5f 08 65 20 69 73 20 6e 6f 74 20 61 20 70 72 6f 70 65 72 20 76 61 6c 75 65   ┆e_ n_ c_ e is not a proper value┆
0x1000…1020 2c 20 6f 72 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 73   ┆, or the                     res┆
0x1020…1040 75 6c 74 69 6e 67 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 77 6f 75 6c 64 20 62 65 20 6e 65 67   ┆ulting file pointer would be neg┆
0x1040…1060 61 74 69 76 65 20 66 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 20   ┆ative for                     a ┆
0x1060…1080 6e 6f 6e 2d 4d 58 49 50 43 20 66 69 6c 65 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45   ┆non-MXIPC file.  S S S SE E E EE┆
0x1080…10a0 08 45 08 45 08 45 20 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08   ┆ E E E A A A AL L L LS S S SO O ┆
0x10a0…10c0 4f 08 4f 0a 20 20 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 20 64 75 70 2c   ┆O O      System Calls (2):  dup,┆
0x10c0…10e0 20 6f 70 65 6e 2c 20 72 65 61 64 72 61 6e 64 6f 6d 2c 20 77 72 69 74 65 72 61 6e 64 6f 6d 0a 0a   ┆ open, readrandom, writerandom  ┆
0x10e0…1100 44 65 63 65 6d 62 65 72 20 31 39 39 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆December 1990                   ┆
0x1100…1120 20 20 20 20 20 20 20 20 54 58 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63   ┆        TX Programmer's Referenc┆
0x1120…1140 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆e                               ┆
0x1140…1148 0a 0a 0a 0a 0a 0a 0a 0a                                                                           ┆        ┆