DataMuseum.dk

top - download

    Length: 10309 (0x2845)
    Names: »msgop.3«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/msgop.3« 

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 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x0040…0060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 73 67 6f 70 28 33 29 0a 0a 0a 0a   ┆ions                msgop(3)    ┆
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 6d 73 67 6f 70 2c 20 6d 73 67 73 6e 64 2c 20 6d 73 67 72 63 76 20 2d 20 6d 65 73 73 61 67   ┆  msgop, msgsnd, msgrcv - messag┆
0x00a0…00c0 65 20 6f 70 65 72 61 74 69 6f 6e 73 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08   ┆e operations  S S S SY Y Y YN N ┆
0x00c0…00e0 4e 08 4e 54 08 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 23 08   ┆N NT T T TA A A AX X X X      # ┆
0x00e0…0100 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c 08   ┆# # #i i i in n n nc c c cl l l ┆
0x0100…0120 6c 75 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08   ┆lu u u ud d d de e e e < < < <s ┆
0x0120…0140 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 74 08 74 08 74 08   ┆s s sy y y ys s s s/ / / /t t t ┆
0x0140…0160 74 79 08 79 08 79 08 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   ┆ty y y yp p p pe e e es s s s. .┆
0x0160…0180 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 23 69   ┆ . .h h h h> > > >      # # # #i┆
0x0180…01a0 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 08 75   ┆ i i in n n nc c c cl l l lu u u┆
0x01a0…01c0 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 73 79   ┆ ud d d de e e e < < < <s s s sy┆
0x01c0…01e0 08 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 69 08 69 08 69 08 69 70 08 70 08 70   ┆ y y ys s s s/ / / /i i i ip p p┆
0x01e0…0200 08 70 63 08 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   ┆ pc c c c. . . .h h h h> > > >  ┆
0x0200…0220 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63   ┆    # # # #i i i in n n nc c c c┆
0x0220…0240 6c 08 6c 08 6c 08 6c 75 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c   ┆l l l lu u u ud d d de e e e < <┆
0x0240…0260 08 3c 08 3c 73 08 73 08 73 08 73 79 08 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f   ┆ < <s s s sy y y ys s s s/ / / /┆
0x0260…0280 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 2e 08 2e 08 2e 08 2e 68 08 68 08   ┆m m m ms s s sg g g g. . . .h h ┆
0x0280…02a0 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74   ┆h h> > > >       i i i in n n nt┆
0x02a0…02c0 08 74 08 74 08 74 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 73 08 73 08   ┆ t t t m m m ms s s sg g g gs s ┆
0x02c0…02e0 73 08 73 6e 08 6e 08 6e 08 6e 64 08 64 08 64 08 64 28 08 28 08 28 08 28 6d 08 6d 08 6d 08 6d 73   ┆s sn n n nd d d d( ( ( (m m m ms┆
0x02e0…0300 08 73 08 73 08 73 71 08 71 08 71 08 71 69 08 69 08 69 08 69 64 08 64 08 64 08 64 2c 08 2c 08 2c   ┆ s s sq q q qi i i id d d d, , ,┆
0x0300…0320 08 2c 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 70 08 70 08 70 08 70 2c   ┆ , m m m ms s s sg g g gp p p p,┆
0x0320…0340 08 2c 08 2c 08 2c 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 73 08 73 08   ┆ , , , m m m ms s s sg g g gs s ┆
0x0340…0360 73 08 73 7a 08 7a 08 7a 08 7a 2c 08 2c 08 2c 08 2c 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73   ┆s sz z z z, , , , m m m ms s s s┆
0x0360…0380 67 08 67 08 67 08 67 66 08 66 08 66 08 66 6c 08 6c 08 6c 08 6c 67 08 67 08 67 08 67 29 08 29 08   ┆g g g gf f f fl l l lg g g g) ) ┆
0x0380…03a0 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 6d   ┆) )      i i i in n n nt t t t m┆
0x03a0…03c0 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 71 08 71 08 71 08 71 69 08 69 08 69 08 69 64 08 64 08 64   ┆ m m ms s s sq q q qi i i id d d┆
0x03c0…03e0 08 64 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 76 08 76 08 76 08 76 6f 08 6f 08 6f 08 6f 69 08 69   ┆ d; ; ; ;      v v v vo o o oi i┆
0x03e0…0400 08 69 08 69 64 08 64 08 64 08 64 20 2a 08 2a 08 2a 08 2a 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08   ┆ i id d d d * * * *m m m ms s s ┆
0x0400…0420 73 67 08 67 08 67 08 67 70 08 70 08 70 08 70 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 73 08 73 08   ┆sg g g gp p p p; ; ; ;      s s ┆
0x0420…0440 73 08 73 69 08 69 08 69 08 69 7a 08 7a 08 7a 08 7a 65 08 65 08 65 08 65 5f 08 5f 08 5f 08 5f 74   ┆s si i i iz z z ze e e e_ _ _ _t┆
0x0440…0460 08 74 08 74 08 74 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 73 08 73 08   ┆ t t t m m m ms s s sg g g gs s ┆
0x0460…0480 73 08 73 7a 08 7a 08 7a 08 7a 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08   ┆s sz z z z; ; ; ;      i i i in ┆
0x0480…04a0 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67   ┆n n nt t t t m m m ms s s sg g g┆
0x04a0…04c0 08 67 66 08 66 08 66 08 66 6c 08 6c 08 6c 08 6c 67 08 67 08 67 08 67 3b 08 3b 08 3b 08 3b 0a 0a   ┆ gf f f fl l l lg g g g; ; ; ;  ┆
0x04c0…04e0 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 6d 08 6d 08 6d   ┆     i i i in n n nt t t t m m m┆
0x04e0…0500 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 72 08 72 08 72 08 72 63 08 63 08 63 08 63 76 08   ┆ ms s s sg g g gr r r rc c c cv ┆
0x0500…0520 76 08 76 08 76 28 08 28 08 28 08 28 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 71 08 71 08 71 08   ┆v v v( ( ( (m m m ms s s sq q q ┆
0x0520…0540 71 69 08 69 08 69 08 69 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 6d 08 6d 08 6d 08 6d 73 08   ┆qi i i id d d d, , , , m m m ms ┆
0x0540…0560 73 08 73 08 73 67 08 67 08 67 08 67 70 08 70 08 70 08 70 2c 08 2c 08 2c 08 2c 20 6d 08 6d 08 6d   ┆s s sg g g gp p p p, , , , m m m┆
0x0560…0580 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 73 08 73 08 73 08 73 7a 08 7a 08 7a 08 7a 2c 08   ┆ ms s s sg g g gs s s sz z z z, ┆
0x0580…05a0 2c 08 2c 08 2c 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 74 08 74 08 74   ┆, , , m m m ms s s sg g g gt t t┆
0x05a0…05c0 08 74 79 08 79 08 79 08 79 70 08 70 08 70 08 70 2c 08 2c 08 2c 08 2c 20 6d 08 6d 08 6d 08 6d 73   ┆ ty y y yp p p p, , , , m m m ms┆
0x05c0…05e0 08 73 08 73 08 73 67 08 67 08 67 08 67 66 08 66 08 66 08 66 6c 08 6c 08 6c 08 6c 67 08 67 08 67   ┆ s s sg g g gf f f fl l l lg g g┆
0x05e0…0600 08 67 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   ┆ g) ) ) )      i i i in n n nt t┆
0x0600…0620 08 74 08 74 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 71 08 71 08 71 08 71 69 08 69 08 69 08   ┆ t t m m m ms s s sq q q qi i i ┆
0x0620…0640 69 64 08 64 08 64 08 64 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 76 08 76 08 76 08 76 6f 08 6f 08   ┆id d d d; ; ; ;      v v v vo o ┆
0x0640…0660 6f 08 6f 69 08 69 08 69 08 69 64 08 64 08 64 08 64 20 2a 08 2a 08 2a 08 2a 6d 08 6d 08 6d 08 6d   ┆o oi i i id d d d * * * *m m m m┆
0x0660…0680 73 08 73 08 73 08 73 67 08 67 08 67 08 67 70 08 70 08 70 08 70 3b 08 3b 08 3b 08 3b 0a 20 20 20   ┆s s s sg g g gp p p p; ; ; ;    ┆
0x0680…06a0 20 20 73 08 73 08 73 08 73 69 08 69 08 69 08 69 7a 08 7a 08 7a 08 7a 65 08 65 08 65 08 65 5f 08   ┆  s s s si i i iz z z ze e e e_ ┆
0x06a0…06c0 5f 08 5f 08 5f 74 08 74 08 74 08 74 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67   ┆_ _ _t t t t m m m ms s s sg g g┆
0x06c0…06e0 08 67 73 08 73 08 73 08 73 7a 08 7a 08 7a 08 7a 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 6c 08 6c   ┆ gs s s sz z z z; ; ; ;      l l┆
0x06e0…0700 08 6c 08 6c 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 67 08 67 08 67 08 67 20 6d 08 6d 08 6d 08   ┆ l lo o o on n n ng g g g m m m ┆
0x0700…0720 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 74 08 74 08 74 08 74 79 08 79 08 79 08 79 70 08 70   ┆ms s s sg g g gt t t ty y y yp p┆
0x0720…0740 08 70 08 70 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 74   ┆ p p; ; ; ;      i i i in n n nt┆
0x0740…0760 08 74 08 74 08 74 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 66 08 66 08   ┆ t t t m m m ms s s sg g g gf f ┆
0x0760…0780 66 08 66 6c 08 6c 08 6c 08 6c 67 08 67 08 67 08 67 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08   ┆f fl l l lg g g g; ; ; ;  D D D ┆
0x0780…07a0 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 49   ┆DE E E ES S S SC C C CR R R RI I┆
0x07a0…07c0 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 4f   ┆ I IP P P PT T T TI I I IO O O O┆
0x07c0…07e0 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67   ┆N N N N      m m m ms s s sg g g┆
0x07e0…0800 08 67 73 08 73 08 73 08 73 6e 08 6e 08 6e 08 6e 64 08 64 08 64 08 64 0a 20 20 20 20 20 5f 08 6d   ┆ gs s s sn n n nd d d d      _ m┆
0x0800…0820 5f 08 73 5f 08 67 5f 08 73 5f 08 6e 5f 08 64 20 69 73 20 75 73 65 64 20 74 6f 20 73 65 6e 64 20   ┆_ s_ g_ s_ n_ d is used to send ┆
0x0820…0840 61 20 6d 65 73 73 61 67 65 20 74 6f 20 74 68 65 20 71 75 65 75 65 20 61 73 73 6f 63 69 61 74 65   ┆a message to the queue associate┆
0x0840…0860 64 0a 20 20 20 20 20 77 69 74 68 20 74 68 65 20 6d 65 73 73 61 67 65 20 71 75 65 75 65 20 69 64   ┆d      with the message queue id┆
0x0860…0880 65 6e 74 69 66 69 65 72 20 73 70 65 63 69 66 69 65 64 20 62 79 20 5f 08 6d 5f 08 73 5f 08 71 5f   ┆entifier specified by _ m_ s_ q_┆
0x0880…08a0 08 69 5f 08 64 2e 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 70 0a 20 20 20 20 20 70 6f 69 6e 74 73   ┆ i_ d.  _ m_ s_ g_ p      points┆
0x08a0…08c0 20 74 6f 20 61 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20 62 75 66 66 65 72 20 74 68 61 74 20 6d   ┆ to a user-defined buffer that m┆
0x08c0…08e0 75 73 74 20 63 6f 6e 74 61 69 6e 20 66 69 72 73 74 20 61 0a 20 20 20 20 20 66 69 65 6c 64 20 6f   ┆ust contain first a      field o┆
0x08e0…0900 66 20 74 79 70 65 20 6c 08 6c 08 6c 08 6c 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 67 08 67 08   ┆f type l l l lo o o on n n ng g ┆
0x0900…0920 67 08 67 20 74 68 61 74 20 77 69 6c 6c 20 73 70 65 63 69 66 79 20 74 68 65 20 74 79 70 65 20 6f   ┆g g that will specify the type o┆
0x0920…0940 66 20 6d 65 73 73 61 67 65 2c 0a 20 20 20 20 20 61 6e 64 20 74 68 65 6e 20 61 20 64 61 74 61 20   ┆f message,      and then a data ┆
0x0940…0960 70 6f 72 74 69 6f 6e 20 74 68 61 74 20 77 69 6c 6c 20 68 6f 6c 64 20 74 68 65 20 74 65 78 74 20   ┆portion that will hold the text ┆
0x0960…0980 6f 66 20 74 68 65 20 6d 65 73 2d 0a 20 20 20 20 20 73 61 67 65 2e 20 54 68 65 20 73 74 72 75 63   ┆of the mes-      sage. The struc┆
0x0980…09a0 74 75 72 65 20 62 65 6c 6f 77 20 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 6f 66 20 77 68 61 74   ┆ture below is an example of what┆
0x09a0…09c0 20 74 68 69 73 20 75 73 65 72 2d 0a 20 20 20 20 20 64 65 66 69 6e 65 64 20 62 75 66 66 65 72 20   ┆ this user-      defined buffer ┆
0x09c0…09e0 6d 69 67 68 74 20 6c 6f 6f 6b 20 6c 69 6b 65 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 73 74 72 75   ┆might look like:            stru┆
0x09e0…0a00 63 74 20 6d 79 6d 73 67 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 6e 67 20 6d   ┆ct mymsg {                long m┆
0x0a00…0a20 74 79 70 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 6d 74 65 78 74 5b   ┆type;                char mtext[┆
0x0a20…0a40 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 5f 08 6d 5f 08 74 5f 08 79 5f 08   ┆];           }       _ m_ t_ y_ ┆
0x0a40…0a60 70 5f 08 65 20 69 73 20 61 20 70 6f 73 69 74 69 76 65 20 69 6e 74 65 67 65 72 20 74 68 61 74 20   ┆p_ e is a positive integer that ┆
0x0a60…0a80 63 61 6e 20 62 65 20 75 73 65 64 20 62 79 20 74 68 65 20 72 65 63 65 69 76 2d 0a 20 20 20 20 20   ┆can be used by the receiv-      ┆
0x0a80…0aa0 69 6e 67 20 70 72 6f 63 65 73 73 20 66 6f 72 20 6d 65 73 73 61 67 65 20 73 65 6c 65 63 74 69 6f   ┆ing process for message selectio┆
0x0aa0…0ac0 6e 20 28 73 65 65 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 72 5f 08 63 5f 08 76 20 62 65 6c 6f 77 29   ┆n (see _ m_ s_ g_ r_ c_ v below)┆
0x0ac0…0ae0 2e 20 20 5f 08 6d 5f 08 74 5f 08 65 5f 08 78 5f 08 74 0a 20 20 20 20 20 69 73 20 61 6e 79 20 74   ┆.  _ m_ t_ e_ x_ t      is any t┆
0x0ae0…0b00 65 78 74 20 6f 66 20 6c 65 6e 67 74 68 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 73 5f 08 7a 20 62 79   ┆ext of length _ m_ s_ g_ s_ z by┆
0x0b00…0b20 74 65 73 2e 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 73 5f 08 7a 20 63 61 6e 20 72 61 6e 67 65 20   ┆tes.  _ m_ s_ g_ s_ z can range ┆
0x0b20…0b40 66 72 6f 6d 20 30 0a 20 20 20 20 20 74 6f 20 61 20 73 79 73 74 65 6d 20 69 6d 70 6f 73 65 64 20   ┆from 0      to a system imposed ┆
0x0b40…0b60 6d 61 78 69 6d 75 6d 2e 0a 0a 20 20 20 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 66 5f 08 6c 5f 08   ┆maximum.       _ m_ s_ g_ f_ l_ ┆
0x0b60…0b80 67 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 61 63 74 69 6f 6e 20 74 6f 20 62 65 20 74 61 6b   ┆g specifies the action to be tak┆
0x0b80…0ba0 65 6e 20 69 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 0a 20 20 20 20 20 74 68 65 20 66 6f   ┆en if one or more of      the fo┆
0x0ba0…0bc0 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 54 68 65   ┆llowing are true:            The┆
0x0bc0…0be0 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 61 6c 72 65 61 64 79 20 6f 6e 20 74 68 65 20   ┆ number of bytes already on the ┆
0x0be0…0c00 71 75 65 75 65 20 69 73 20 65 71 75 61 6c 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 6d 08 6d 08   ┆queue is equal to           m m ┆
0x0c00…0c20 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 5f 08 5f 08 5f 08 5f 71 08 71 08 71 08 71 62   ┆m ms s s sg g g g_ _ _ _q q q qb┆
0x0c20…0c40 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┆
0x0c40…0c60 08 73 20 73 65 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   ┆ s see < < < <s s s sy y y ys s ┆
0x0c60…0c80 73 08 73 2f 08 2f 08 2f 08 2f 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 2e   ┆s s/ / / /m m m ms s s sg g g g.┆
0x0c80…0ca0 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 2e 0a 0a 20 20 20 20 20 20 20 20 20   ┆ . . .h h h h> > > >.           ┆
0x0ca0…0cc0 20 54 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 6d 65 73 73 61 67 65 73 20 6f 6e   ┆ The total number of messages on┆
0x0cc0…0ce0 20 61 6c 6c 20 71 75 65 75 65 73 20 73 79 73 74 65 6d 2d 77 69 64 65 0a 20 20 20 20 20 20 20 20   ┆ all queues system-wide         ┆
0x0ce0…0d00 20 20 69 73 20 65 71 75 61 6c 20 74 6f 20 74 68 65 20 73 79 73 74 65 6d 20 69 6d 70 6f 73 65 64   ┆  is equal to the system imposed┆
0x0d00…0d20 20 6c 69 6d 69 74 2e 0a 0a 20 20 20 20 20 54 68 65 73 65 20 61 63 74 69 6f 6e 73 20 61 72 65 20   ┆ limit.       These actions are ┆
0x0d20…0d40 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 49 66 20 28 5f 08 6d 5f 08   ┆as follows:            If (_ m_ ┆
0x0d40…0d60 73 5f 08 67 5f 08 66 5f 08 6c 5f 08 67 20 26 20 49 50 43 5f 4e 4f 57 41 49 54 29 20 69 73 20 6e   ┆s_ g_ f_ l_ g & IPC_NOWAIT) is n┆
0x0d60…0d80 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6d 65 73 73 61 67 65 20 77 69 6c 6c 0a 20 20 20 20 20 20   ┆on-zero, the message will       ┆
0x0d80…0da0 20 20 20 20 6e 6f 74 20 62 65 20 73 65 6e 74 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 69 6e 67 20   ┆    not be sent and the calling ┆
0x0da0…0dc0 70 72 6f 63 65 73 73 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 69 6d 6d 65 64 69 2d 0a 20 20 20 20   ┆process will return immedi-     ┆
0x0dc0…0de0 20 20 20 20 20 20 61 74 65 6c 79 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 66 20 28 5f 08 6d 5f   ┆      ately.            If (_ m_┆
0x0de0…0e00 08 73 5f 08 67 5f 08 66 5f 08 6c 5f 08 67 20 26 20 49 50 43 5f 4e 4f 57 41 49 54 29 20 69 73 20   ┆ s_ g_ f_ l_ g & IPC_NOWAIT) is ┆
0x0e00…0e20 65 71 75 61 6c 20 74 6f 20 7a 65 72 6f 2c 20 74 68 65 20 63 61 6c 6c 69 6e 67 0a 20 20 20 20 20   ┆equal to zero, the calling      ┆
0x0e20…0e40 20 20 20 20 20 70 72 6f 63 65 73 73 20 77 69 6c 6c 20 73 75 73 70 65 6e 64 20 65 78 65 63 75 74   ┆     process will suspend execut┆
0x0e40…0e60 69 6f 6e 20 75 6e 74 69 6c 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 2d 0a 20 20 20   ┆ion until one of the follow-    ┆
0x0e60…0e80 20 20 20 20 20 20 20 69 6e 67 20 6f 63 63 75 72 73 3a 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 20 20   ┆       ing occurs:              ┆
0x0e80…0ea0 20 20 20 20 20 20 20 20 20 20 20 54 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 72 65 73 70 6f 6e 73   ┆           The condition respons┆
0x0ea0…0ec0 69 62 6c 65 20 66 6f 72 20 74 68 65 20 73 75 73 70 65 6e 73 69 6f 6e 20 6e 6f 0a 20 20 20 20 20   ┆ible for the suspension no      ┆
0x0ec0…0ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 6e 67 65 72 20 65 78 69 73 74 73 2c 20 69 6e 20 77   ┆             longer exists, in w┆
0x0ee0…0f00 68 69 63 68 20 63 61 73 65 20 74 68 65 20 6d 65 73 73 61 67 65 20 69 73 0a 20 20 20 20 20 20 20   ┆hich case the message is        ┆
0x0f00…0f20 20 20 20 20 20 20 20 20 20 20 20 73 65 6e 74 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆           sent.                ┆
0x0f20…0f40 20 20 20 20 5f 08 6d 5f 08 73 5f 08 71 5f 08 69 5f 08 64 20 69 73 20 72 65 6d 6f 76 65 64 20 66   ┆    _ m_ s_ q_ i_ d is removed f┆
0x0f40…0f60 72 6f 6d 20 74 68 65 20 73 79 73 74 65 6d 20 28 73 65 65 0a 20 20 20 20 20 20 20 20 20 20 20 20   ┆rom the system (see             ┆
0x0f60…0f80 20 20 20 20 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 63 5f 08 74 5f 08 6c 28 33 29 29 2e 20 20 57   ┆      _ m_ s_ g_ c_ t_ l(3)).  W┆
0x0f80…0fa0 68 65 6e 20 74 68 69 73 20 6f 63 63 75 72 73 2c 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f   ┆hen this occurs, _ e_ r_ r_ n_ o┆
0x0fa0…0fc0 20 69 73 20 73 65 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 71 75 61 6c 20   ┆ is set                   equal ┆
0x0fc0…0fe0 74 6f 20 5b 45 49 44 52 4d 5d 2c 20 61 6e 64 20 61 20 76 61 6c 75 65 20 6f 66 20 2d 31 20 69 73   ┆to [EIDRM], and a value of -1 is┆
0x0fe0…1000 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e 0a 0a 20 20   ┆                   returned.    ┆
0x1000…1020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63   ┆                The calling proc┆
0x1020…1040 65 73 73 20 72 65 63 65 69 76 65 73 20 61 20 73 69 67 6e 61 6c 20 74 68 61 74 20 69 73 0a 20 20   ┆ess receives a signal that is   ┆
0x1040…1060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 62 65 20 63 61 75 67 68 74 2e 20 20 49   ┆                to be caught.  I┆
0x1060…1080 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 6d 65 73 73 61 67 65 20 69 73 20 6e 6f 74 0a 20   ┆n this case the message is not  ┆
0x1080…10a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 6e 74 20 61 6e 64 20 74 68 65 20 63 61   ┆                 sent and the ca┆
0x10a0…10c0 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 20 72 65 73 75 6d 65 73 20 65 78 65 63 75 74 69 6f 6e 0a   ┆lling process resumes execution ┆
0x10c0…10e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 20 74 68 65 20 6d 61 6e 6e 65 72 20   ┆                  in the manner ┆
0x10e0…1100 70 72 65 73 63 72 69 62 65 64 20 69 6e 20 5f 08 73 5f 08 69 5f 08 67 5f 08 6e 5f 08 61 5f 08 6c   ┆prescribed in _ s_ i_ g_ n_ a_ l┆
0x1100…1120 28 34 29 29 2e 0a 20 20 20 20 20 55 70 6f 6e 20 73 75 63 63 65 73 73 66 75 6c 20 63 6f 6d 70 6c   ┆(4)).      Upon successful compl┆
0x1120…1140 65 74 69 6f 6e 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 63 74 69 6f 6e 73 20 61 72 65   ┆etion, the following actions are┆
0x1140…1160 20 74 61 6b 65 6e 0a 20 20 20 20 20 77 69 74 68 20 72 65 73 70 65 63 74 20 74 6f 20 74 68 65 20   ┆ taken      with respect to the ┆
0x1160…1180 64 61 74 61 20 73 74 72 75 63 74 75 72 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 5f   ┆data structure associated with _┆
0x1180…11a0 08 6d 5f 08 73 5f 08 71 5f 08 69 5f 08 64 0a 20 20 20 20 20 28 73 65 65 20 3c 08 3c 08 3c 08 3c   ┆ m_ s_ q_ i_ d      (see < < < <┆
0x11a0…11c0 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 6d 08 6d 08   ┆s s s sy y y ys s s s/ / / /m m ┆
0x11c0…11e0 6d 08 6d 73 08 73 08 73 08 73 67 08 67 08 67 08 67 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e   ┆m ms s s sg g g g. . . .h h h h>┆
0x11e0…1200 08 3e 08 3e 08 3e 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 5f 08 71   ┆ > > >:            _ m_ s_ g__ q┆
0x1200…1220 5f 08 6e 5f 08 75 5f 08 6d 20 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 20 62 79 20 31 2e 0a 0a   ┆_ n_ u_ m is incremented by 1.  ┆
0x1220…1240 20 20 20 20 20 20 20 20 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 5f 08 6c 5f 08 73 5f 08 70 5f 08 69   ┆          _ m_ s_ g__ l_ s_ p_ i┆
0x1240…1260 5f 08 64 20 69 73 20 73 65 74 20 65 71 75 61 6c 20 74 6f 20 74 68 65 20 70 72 6f 63 65 73 73 20   ┆_ d is set equal to the process ┆
0x1260…1280 49 44 20 6f 66 20 74 68 65 20 63 61 6c 6c 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 70 72 6f 63   ┆ID of the calling           proc┆
0x1280…12a0 65 73 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 5f 08 73 5f 08 74   ┆ess.            _ m_ s_ g__ s_ t┆
0x12a0…12c0 5f 08 69 5f 08 6d 5f 08 65 20 69 73 20 73 65 74 20 65 71 75 61 6c 20 74 6f 20 74 68 65 20 63 75   ┆_ i_ m_ e is set equal to the cu┆
0x12c0…12e0 72 72 65 6e 74 20 74 69 6d 65 2e 0a 0a 20 20 20 20 20 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73   ┆rrent time.       m m m ms s s s┆
0x12e0…1300 67 08 67 08 67 08 67 72 08 72 08 72 08 72 63 08 63 08 63 08 63 76 08 76 08 76 08 76 0a 20 20 20   ┆g g g gr r r rc c c cv v v v    ┆
0x1300…1320 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 72 5f 08 63 5f 08 76 20 72 65 61 64 73 20 61 20 6d 65 73   ┆  _ m_ s_ g_ r_ c_ v reads a mes┆
0x1320…1340 73 61 67 65 20 66 72 6f 6d 20 74 68 65 20 71 75 65 75 65 20 61 73 73 6f 63 69 61 74 65 64 20 77   ┆sage from the queue associated w┆
0x1340…1360 69 74 68 20 74 68 65 0a 20 20 20 20 20 6d 65 73 73 61 67 65 20 71 75 65 75 65 20 69 64 65 6e 74   ┆ith the      message queue ident┆
0x1360…1380 69 66 69 65 72 20 73 70 65 63 69 66 69 65 64 20 62 79 20 5f 08 6d 5f 08 73 5f 08 71 5f 08 69 5f   ┆ifier specified by _ m_ s_ q_ i_┆
0x1380…13a0 08 64 20 61 6e 64 20 70 6c 61 63 65 73 20 69 74 20 69 6e 0a 20 20 20 20 20 74 68 65 20 75 73 65   ┆ d and places it in      the use┆
0x13a0…13c0 72 2d 64 65 66 69 6e 65 64 20 62 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 5f   ┆r-defined buffer pointed to by _┆
0x13c0…13e0 08 6d 5f 08 73 5f 08 67 5f 08 70 2e 20 20 54 68 65 20 62 75 66 66 65 72 20 6d 75 73 74 0a 20 20   ┆ m_ s_ g_ p.  The buffer must   ┆
0x13e0…1400 20 20 20 63 6f 6e 74 61 69 6e 20 66 69 72 73 74 20 61 20 66 69 65 6c 64 20 6f 66 20 74 79 70 65   ┆   contain first a field of type┆
0x1400…1420 20 6c 08 6c 08 6c 08 6c 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 67 08 67 08 67 08 67 20 74 68   ┆ l l l lo o o on n n ng g g g th┆
0x1420…1440 61 74 20 77 69 6c 6c 20 73 70 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 20 74 79 70 65 20 6f 66   ┆at will specify the      type of┆
0x1440…1460 20 74 68 65 20 6d 65 73 73 61 67 65 2c 20 61 6e 64 20 74 68 65 6e 20 61 20 64 61 74 61 20 70 6f   ┆ the message, and then a data po┆
0x1460…1480 72 74 69 6f 6e 20 74 68 61 74 20 77 69 6c 6c 20 68 6f 6c 64 0a 20 20 20 20 20 74 68 65 20 64 61   ┆rtion that will hold      the da┆
0x1480…14a0 74 61 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 6d 65 73 73 61 67 65 2e 20 54 68 65 20 73 74 72   ┆ta bytes of the message. The str┆
0x14a0…14c0 75 63 74 75 72 65 20 62 65 6c 6f 77 20 69 73 20 61 6e 0a 20 20 20 20 20 65 78 61 6d 70 6c 65 20   ┆ucture below is an      example ┆
0x14c0…14e0 6f 66 20 77 68 61 74 20 74 68 69 73 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20 62 75 66 66 65 72   ┆of what this user-defined buffer┆
0x14e0…1500 20 6d 69 67 68 74 20 6c 6f 6f 6b 20 6c 69 6b 65 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 73 74 72   ┆ might look like:            str┆
0x1500…1520 75 63 74 20 6d 79 6d 73 67 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 6e 67 20   ┆uct mymsg {                long ┆
0x1520…1540 6d 74 79 70 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 6d 74 65 78 74   ┆mtype;                char mtext┆
0x1540…1560 5b 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 5f 08 6d 5f 08 74 5f 08 79 5f   ┆[];           }       _ m_ t_ y_┆
0x1560…1580 08 70 5f 08 65 20 69 73 20 74 68 65 20 72 65 63 65 69 76 65 64 20 6d 65 73 73 61 67 65 27 73 20   ┆ p_ e is the received message's ┆
0x1580…15a0 74 79 70 65 20 61 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 0a 20 20 20 20 20 73 65   ┆type as specified by the      se┆
0x15a0…15c0 6e 64 69 6e 67 20 70 72 6f 63 65 73 73 2e 20 20 5f 08 6d 5f 08 74 5f 08 65 5f 08 78 5f 08 74 20   ┆nding process.  _ m_ t_ e_ x_ t ┆
0x15c0…15e0 69 73 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 6d 65 73 73 61 67 65 2e 20 20 5f 08 6d   ┆is the text of the message.  _ m┆
0x15e0…1600 5f 08 73 5f 08 67 5f 08 73 5f 08 7a 0a 20 20 20 20 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20   ┆_ s_ g_ s_ z      specifies the ┆
0x1600…1620 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f 66 20 5f 08 6d 5f 08 74 5f 08 65 5f 08 78 5f 08 74   ┆size in bytes of _ m_ t_ e_ x_ t┆
0x1620…1640 2e 20 20 54 68 65 20 72 65 63 65 69 76 65 64 20 6d 65 73 73 61 67 65 0a 20 20 20 20 20 69 73 20   ┆.  The received message      is ┆
0x1640…1660 74 72 75 6e 63 61 74 65 64 20 74 6f 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 73 5f 08 7a 20 62 79 74   ┆truncated to _ m_ s_ g_ s_ z byt┆
0x1660…1680 65 73 20 69 66 20 69 74 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 5f 08 6d 5f 08 73 5f 08   ┆es if it is larger than _ m_ s_ ┆
0x1680…16a0 67 5f 08 73 5f 08 7a 20 61 6e 64 0a 20 20 20 20 20 28 5f 08 6d 5f 08 73 5f 08 67 5f 08 66 5f 08   ┆g_ s_ z and      (_ m_ s_ g_ f_ ┆
0x16a0…16c0 6c 5f 08 67 20 26 20 4d 53 47 5f 4e 4f 45 52 52 4f 52 29 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e   ┆l_ g & MSG_NOERROR) is non-zero.┆
0x16c0…16e0 20 20 54 68 65 20 74 72 75 6e 63 61 74 65 64 20 70 61 72 74 20 6f 66 0a 20 20 20 20 20 74 68 65   ┆  The truncated part of      the┆
0x16e0…1700 20 6d 65 73 73 61 67 65 20 69 73 20 6c 6f 73 74 20 61 6e 64 20 6e 6f 20 69 6e 64 69 63 61 74 69   ┆ message is lost and no indicati┆
0x1700…1720 6f 6e 20 6f 66 20 74 68 65 20 74 72 75 6e 63 61 74 69 6f 6e 20 69 73 0a 20 20 20 20 20 67 69 76   ┆on of the truncation is      giv┆
0x1720…1740 65 6e 20 74 6f 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 2e 0a 0a 20 20 20 20   ┆en to the calling process.      ┆
0x1740…1760 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 74 5f 08 79 5f 08 70 20 73 70 65 63 69 66 69 65 73 20 74 68   ┆ _ m_ s_ g_ t_ y_ p specifies th┆
0x1760…1780 65 20 74 79 70 65 20 6f 66 20 6d 65 73 73 61 67 65 20 72 65 71 75 65 73 74 65 64 20 61 73 20 66   ┆e type of message requested as f┆
0x1780…17a0 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 49 66 20 5f 08 6d 5f 08 73 5f 08 67 5f   ┆ollows:            If _ m_ s_ g_┆
0x17a0…17c0 08 74 5f 08 79 5f 08 70 20 69 73 20 65 71 75 61 6c 20 74 6f 20 30 2c 20 74 68 65 20 66 69 72 73   ┆ t_ y_ p is equal to 0, the firs┆
0x17c0…17e0 74 20 6d 65 73 73 61 67 65 20 6f 6e 20 74 68 65 20 71 75 65 75 65 0a 20 20 20 20 20 20 20 20 20   ┆t message on the queue          ┆
0x17e0…1800 20 69 73 20 72 65 63 65 69 76 65 64 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 66 20 5f 08 6d 5f   ┆ is received.            If _ m_┆
0x1800…1820 08 73 5f 08 67 5f 08 74 5f 08 79 5f 08 70 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 30   ┆ s_ g_ t_ y_ p is greater than 0┆
0x1820…1840 2c 20 74 68 65 20 66 69 72 73 74 20 6d 65 73 73 61 67 65 20 6f 66 20 74 79 70 65 0a 20 20 20 20   ┆, the first message of type     ┆
0x1840…1860 20 20 20 20 20 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 74 5f 08 79 5f 08 70 20 69 73 20 72 65 63 65   ┆      _ m_ s_ g_ t_ y_ p is rece┆
0x1860…1880 69 76 65 64 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 66 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 74   ┆ived.            If _ m_ s_ g_ t┆
0x1880…18a0 5f 08 79 5f 08 70 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 30 2c 20 74 68 65 20 66 69 72 73 74   ┆_ y_ p is less than 0, the first┆
0x18a0…18c0 20 6d 65 73 73 61 67 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 6c 6f 77 65 73 74   ┆ message of the           lowest┆
0x18c0…18e0 20 74 79 70 65 20 74 68 61 74 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c   ┆ type that is less than or equal┆
0x18e0…1900 20 74 6f 20 74 68 65 20 61 62 73 6f 6c 75 74 65 0a 20 20 20 20 20 20 20 20 20 20 76 61 6c 75 65   ┆ to the absolute           value┆
0x1900…1920 20 6f 66 20 5f 08 6d 5f 08 73 5f 08 67 5f 08 74 5f 08 79 5f 08 70 20 69 73 20 72 65 63 65 69 76   ┆ of _ m_ s_ g_ t_ y_ p is receiv┆
[…truncated at 200 lines…]