|
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: p
Length: 3231 (0xc9f)
Names: »pipe.2«
└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
└─⟦bbf173f5c⟧ »0004«
└─⟦this⟧ »./usr/man/cat2/pipe.2«
0x000…020 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_┆
0x020…040 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┆
0x040…060 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 69 70 65 28 32 29 0a 0a 0a 0a ┆s pipe(2) ┆
0x060…080 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 ┆
0x080…0a0 20 20 70 69 70 65 20 2d 20 63 72 65 61 74 65 20 61 20 63 68 61 6e 6e 65 6c 20 66 6f 72 20 69 6e ┆ pipe - create a channel for in┆
0x0a0…0c0 74 65 72 70 72 6f 63 65 73 73 20 63 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 0a 0a 53 08 53 08 53 08 ┆terprocess communication S S S ┆
0x0c0…0e0 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 08 58 ┆SY Y Y YN N N NT T T TA A A AX X┆
0x0e0…100 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 74 20 ┆ X X i i i in n n nt t t t ┆
0x100…120 70 08 70 08 70 08 70 69 08 69 08 69 08 69 70 08 70 08 70 08 70 65 08 65 08 65 08 65 28 08 28 08 ┆p p p pi i i ip p p pe e e e( ( ┆
0x120…140 28 08 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 ┆( (f f f fi i i il l l ld d d de┆
0x140…160 08 65 08 65 08 65 73 08 73 08 73 08 73 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08 69 08 ┆ e e es s s s) ) ) ) i i i ┆
0x160…180 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 6c 08 ┆in n n nt t t t f f f fi i i il ┆
0x180…1a0 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 5b 08 5b 08 5b 08 ┆l l ld d d de e e es s s s[ [ [ ┆
0x1a0…1c0 5b 32 08 32 08 32 08 32 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 ┆[2 2 2 2] ] ] ]; ; ; ; D D D DE┆
0x1c0…1e0 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 08 49 ┆ E E ES S S SC C C CR R R RI I I┆
0x1e0…200 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 4e 08 ┆ IP P P PT T T TI I I IO O O ON ┆
0x200…220 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 70 5f 08 69 5f 08 70 5f 08 65 28 29 20 66 75 ┆N N N The _ p_ i_ p_ e() fu┆
0x220…240 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 63 72 65 61 74 65 20 61 20 70 69 70 65 20 61 6e 64 20 70 6c ┆nction will create a pipe and pl┆
0x240…260 61 63 65 20 74 77 6f 20 66 69 6c 65 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 6f 72 73 2c 20 6f ┆ace two file descriptors, o┆
0x260…280 6e 65 20 65 61 63 68 20 69 6e 74 6f 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 5f 08 66 5f 08 ┆ne each into the arguments _ f_ ┆
0x280…2a0 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 5f 08 30 5d 20 61 6e 64 0a 20 20 20 20 20 5f 08 66 5f ┆i_ l_ d_ e_ s[_ 0] and _ f_┆
0x2a0…2c0 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 5f 08 31 5d 2c 20 74 68 61 74 20 72 65 66 65 72 20 ┆ i_ l_ d_ e_ s[_ 1], that refer ┆
0x2c0…2e0 74 6f 20 74 68 65 20 6f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 66 6f ┆to the open file descriptions fo┆
0x2e0…300 72 20 74 68 65 0a 20 20 20 20 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 65 6e 64 73 20 6f ┆r the read and write ends o┆
0x300…320 66 20 74 68 65 20 70 69 70 65 2e 20 54 68 65 69 72 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 73 ┆f the pipe. Their integer values┆
0x320…340 20 77 69 6c 6c 0a 20 20 20 20 20 62 65 20 74 68 65 20 74 77 6f 20 6c 6f 77 65 73 74 20 61 76 61 ┆ will be the two lowest ava┆
0x340…360 69 6c 61 62 6c 65 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 74 68 65 20 5f 08 70 5f 08 69 ┆ilable at the time of the _ p_ i┆
0x360…380 5f 08 70 5f 08 65 28 29 20 66 75 6e 63 2d 0a 20 20 20 20 20 74 69 6f 6e 20 63 61 6c 6c 2e 20 54 ┆_ p_ e() func- tion call. T┆
0x380…3a0 68 65 20 4f 5f 4e 4f 4e 42 4c 4f 43 4b 20 66 6c 61 67 20 77 69 6c 6c 20 62 65 20 63 6c 65 61 72 ┆he O_NONBLOCK flag will be clear┆
0x3a0…3c0 20 6f 6e 20 62 6f 74 68 20 66 69 6c 65 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 6f 72 73 2e 20 ┆ on both file descriptors. ┆
0x3c0…3e0 28 54 68 65 20 5f 08 66 5f 08 63 5f 08 6e 5f 08 74 5f 08 6c 28 29 20 66 75 6e 63 74 69 6f 6e 20 ┆(The _ f_ c_ n_ t_ l() function ┆
0x3e0…400 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 68 65 0a 20 20 20 20 20 4f 5f 4e 4f ┆can be used to set the O_NO┆
0x400…420 4e 42 4c 4f 43 4b 20 66 6c 61 67 2e 29 0a 0a 20 20 20 20 20 44 61 74 61 20 63 61 6e 20 62 65 20 ┆NBLOCK flag.) Data can be ┆
0x420…440 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 5f ┆written to the file descriptor _┆
0x440…460 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 5f 08 31 5d 20 61 6e 64 0a 20 20 20 20 20 ┆ f_ i_ l_ d_ e_ s[_ 1] and ┆
0x460…480 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 5f 08 ┆read from the file descriptor _ ┆
0x480…4a0 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 5f 08 30 5d 2e 20 20 41 20 72 65 61 64 20 6f ┆f_ i_ l_ d_ e_ s[_ 0]. A read o┆
0x4a0…4c0 6e 20 74 68 65 20 66 69 6c 65 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 6f 72 20 5f 08 66 5f 08 ┆n the file descriptor _ f_ ┆
0x4c0…4e0 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 5f 08 30 5d 20 77 69 6c 6c 20 61 63 63 65 73 73 20 64 ┆i_ l_ d_ e_ s[_ 0] will access d┆
0x4e0…500 61 74 61 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 66 69 6c 65 0a 20 20 20 20 20 64 65 73 ┆ata written to the file des┆
0x500…520 63 72 69 70 74 6f 72 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 5f 08 31 5d 20 ┆criptor _ f_ i_ l_ d_ e_ s[_ 1] ┆
0x520…540 6f 6e 20 61 20 66 69 72 73 74 2d 69 6e 2d 66 69 72 73 74 2d 6f 75 74 20 62 61 73 69 73 2e 0a 0a ┆on a first-in-first-out basis. ┆
0x540…560 20 20 20 20 20 41 20 70 72 6f 63 65 73 73 20 68 61 73 20 74 68 65 20 70 69 70 65 20 6f 70 65 6e ┆ A process has the pipe open┆
0x560…580 20 66 6f 72 20 72 65 61 64 69 6e 67 20 28 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 6c 79 2c 0a 20 ┆ for reading (correspondingly, ┆
0x580…5a0 20 20 20 20 77 72 69 74 69 6e 67 29 20 69 66 20 69 74 20 68 61 73 20 61 20 66 69 6c 65 20 64 65 ┆ writing) if it has a file de┆
0x5a0…5c0 73 63 72 69 70 74 6f 72 20 6f 70 65 6e 20 74 68 61 74 20 72 65 66 65 72 73 20 74 6f 20 74 68 65 ┆scriptor open that refers to the┆
0x5c0…5e0 0a 20 20 20 20 20 72 65 61 64 20 65 6e 64 2c 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f ┆ read end, _ f_ i_ l_ d_ e_┆
0x5e0…600 08 73 5b 5f 08 30 5d 20 28 77 72 69 74 65 20 65 6e 64 2c 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 ┆ s[_ 0] (write end, _ f_ i_ l_ d┆
0x600…620 5f 08 65 5f 08 73 5b 5f 08 31 5d 29 2e 0a 0a 20 20 20 20 20 55 70 6f 6e 20 73 75 63 63 65 73 73 ┆_ e_ s[_ 1]). Upon success┆
0x620…640 66 75 6c 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 74 68 65 20 5f 08 70 5f 08 69 5f 08 70 5f 08 65 ┆ful completion, the _ p_ i_ p_ e┆
0x640…660 28 29 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 6d 61 72 6b 0a 20 20 20 20 20 66 6f 72 20 75 ┆() function will mark for u┆
0x660…680 70 64 61 74 65 20 74 68 65 20 5f 08 73 5f 08 74 5f 5f 08 61 5f 08 74 5f 08 69 5f 08 6d 5f 08 65 ┆pdate the _ s_ t__ a_ t_ i_ m_ e┆
0x680…6a0 2c 20 5f 08 73 5f 08 74 5f 5f 08 63 5f 08 74 5f 08 69 5f 08 6d 5f 08 65 20 61 6e 64 20 5f 08 73 ┆, _ s_ t__ c_ t_ i_ m_ e and _ s┆
0x6a0…6c0 5f 08 74 5f 5f 08 6d 5f 08 74 5f 08 69 5f 08 6d 5f 08 65 20 66 69 65 6c 64 73 20 6f 66 20 74 68 ┆_ t__ m_ t_ i_ m_ e fields of th┆
0x6c0…6e0 65 0a 20 20 20 20 20 70 69 70 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 46 44 5f 43 4c 4f 45 58 45 ┆e pipe. The FD_CLOEXE┆
0x6e0…700 43 20 66 6c 61 67 20 77 69 6c 6c 20 62 65 20 63 6c 65 61 72 20 6f 6e 20 62 6f 74 68 20 66 69 6c ┆C flag will be clear on both fil┆
0x700…720 65 20 64 65 73 63 72 69 70 74 6f 72 73 2e 0a 0a 20 20 20 20 20 45 08 45 08 45 08 45 6d 08 6d 08 ┆e descriptors. E E E Em m ┆
0x720…740 6d 08 6d 70 08 70 08 70 08 70 74 08 74 08 74 08 74 79 08 79 08 79 08 79 20 50 08 50 08 50 08 50 ┆m mp p p pt t t ty y y y P P P P┆
0x740…760 69 08 69 08 69 08 69 70 08 70 08 70 08 70 65 08 65 08 65 08 65 73 08 73 08 73 08 73 0a 20 20 20 ┆i i i ip p p pe e e es s s s ┆
0x760…780 20 20 41 20 70 69 70 65 20 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20 65 6d 70 74 79 20 69 66 20 ┆ A pipe is considered empty if ┆
0x780…7a0 69 74 20 68 61 73 20 6e 6f 20 62 75 66 66 65 72 65 64 20 64 61 74 61 2e 20 20 5f 08 72 5f 08 65 ┆it has no buffered data. _ r_ e┆
0x7a0…7c0 5f 08 61 5f 08 64 0a 20 20 20 20 20 63 61 6c 6c 73 20 6f 6e 20 61 6e 20 65 6d 70 74 79 20 70 69 ┆_ a_ d calls on an empty pi┆
0x7c0…7e0 70 65 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 20 65 6e 64 20 28 61 6c 6c 20 77 72 69 74 65 20 ┆pe with only one end (all write ┆
0x7e0…800 66 69 6c 65 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 6f 72 73 20 63 6c 6f 73 65 64 29 20 72 65 ┆file descriptors closed) re┆
0x800…820 74 75 72 6e 73 20 61 6e 20 65 6e 64 2d 6f 66 2d 66 69 6c 65 2e 20 20 41 20 73 69 67 6e 61 6c 20 ┆turns an end-of-file. A signal ┆
0x820…840 69 73 0a 20 20 20 20 20 67 65 6e 65 72 61 74 65 64 20 69 66 20 61 20 77 72 69 74 65 20 6f 6e 20 ┆is generated if a write on ┆
0x840…860 61 20 70 69 70 65 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 20 65 6e 64 20 69 73 0a 20 20 20 20 ┆a pipe with only one end is ┆
0x860…880 20 61 74 74 65 6d 70 74 65 64 2e 0a 0a 20 20 20 20 20 4d 08 4d 08 4d 08 4d 75 08 75 08 75 08 75 ┆ attempted. M M M Mu u u u┆
0x880…8a0 6c 08 6c 08 6c 08 6c 74 08 74 08 74 08 74 69 08 69 08 69 08 69 2d 08 2d 08 2d 08 2d 50 08 50 08 ┆l l l lt t t ti i i i- - - -P P ┆
0x8a0…8c0 50 08 50 55 08 55 08 55 08 55 20 53 08 53 08 53 08 53 79 08 79 08 79 08 79 73 08 73 08 73 08 73 ┆P PU U U U S S S Sy y y ys s s s┆
0x8c0…8e0 74 08 74 08 74 08 74 65 08 65 08 65 08 65 6d 08 6d 08 6d 08 6d 73 08 73 08 73 08 73 0a 20 20 20 ┆t t t te e e em m m ms s s s ┆
0x8e0…900 20 20 50 69 70 65 73 20 61 72 65 20 65 66 66 65 63 74 69 76 65 20 6f 6e 6c 79 20 77 69 74 68 69 ┆ Pipes are effective only withi┆
0x900…920 6e 20 6f 6e 65 20 50 55 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45 54 08 54 08 54 08 54 ┆n one PU. R R R RE E E ET T T T┆
0x920…940 55 08 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 ┆U U U UR R R RN N N N V V V VA A┆
0x940…960 08 41 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 54 ┆ A AL L L LU U U UE E E E T┆
0x960…980 68 65 20 66 75 6e 63 74 69 6f 6e 20 76 61 6c 75 65 20 7a 65 72 6f 20 69 73 20 72 65 74 75 72 6e ┆he function value zero is return┆
0x980…9a0 65 64 20 69 66 20 74 68 65 20 70 69 70 65 20 77 61 73 20 63 72 65 61 74 65 64 3b 0a 20 20 20 20 ┆ed if the pipe was created; ┆
0x9a0…9c0 20 2d 31 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 0a 0a 45 08 45 08 45 ┆ -1 if an error occurred. E E E┆
0x9c0…9e0 08 45 52 08 52 08 52 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 ┆ ER R R RR R R RO O O OR R R RS ┆
0x9e0…a00 53 08 53 08 53 0a 20 20 20 20 20 54 68 65 20 5f 08 70 5f 08 69 5f 08 70 5f 08 65 20 63 61 6c 6c ┆S S S The _ p_ i_ p_ e call┆
0xa00…a20 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 3a 0a 0a 20 20 20 20 20 5b 45 46 41 55 4c 54 5d 20 20 20 ┆ will fail if: [EFAULT] ┆
0xa20…a40 20 20 20 20 54 68 65 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 20 62 75 66 66 65 ┆ The _ f_ i_ l_ d_ e_ s buffe┆
0xa40…a60 72 20 69 73 20 69 6e 20 61 6e 20 69 6e 76 61 6c 69 64 20 61 72 65 61 20 6f 66 0a 20 20 20 20 20 ┆r is in an invalid area of ┆
0xa60…a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 70 72 6f 63 65 73 73 27 73 20 61 64 64 ┆ the process's add┆
0xa80…aa0 72 65 73 73 20 73 70 61 63 65 2e 0a 0a 20 20 20 20 20 5b 45 4d 46 49 4c 45 5d 20 20 20 20 20 20 ┆ress space. [EMFILE] ┆
0xaa0…ac0 20 4d 6f 72 65 20 74 68 61 6e 20 7b 4f 50 45 4e 5f 4d 41 58 7d 20 6d 69 6e 75 73 20 74 77 6f 20 ┆ More than {OPEN_MAX} minus two ┆
0xac0…ae0 66 69 6c 65 20 64 65 73 63 72 69 70 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆file descrip- ┆
0xae0…b00 20 20 74 6f 72 73 20 61 72 65 20 61 6c 72 65 61 64 79 20 69 6e 20 75 73 65 20 62 79 20 74 68 69 ┆ tors are already in use by thi┆
0xb00…b20 73 20 70 72 6f 63 65 73 73 2e 0a 0a 20 20 20 20 20 5b 45 4e 46 49 4c 45 5d 20 20 20 20 20 20 20 ┆s process. [ENFILE] ┆
0xb20…b40 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 20 6f 70 65 ┆The number of simultaneously ope┆
0xb40…b60 6e 20 66 69 6c 65 73 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 ┆n files in t┆
0xb60…b80 68 65 20 73 79 73 74 65 6d 20 77 6f 75 6c 64 20 65 78 63 65 65 64 20 74 68 65 20 6c 69 6d 69 74 ┆he system would exceed the limit┆
0xb80…ba0 20 6f 66 20 74 68 65 20 73 79 73 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ┆ of the sys- ┆
0xba0…bc0 20 74 65 6d 20 28 7b 53 59 53 5f 4f 50 45 4e 7d 29 2e 0a 0a 0a 0a 0a 0a 0a 0a 53 08 53 08 53 08 ┆ tem ({SYS_OPEN}). S S S ┆
0xbc0…be0 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 53 08 ┆SE E E EE E E E A A A AL L L LS ┆
0xbe0…c00 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 ┆S S SO O O O System Calls (┆
0xc00…c20 32 29 3a 20 20 66 63 6e 74 6c 2c 20 72 65 61 64 2c 20 73 6f 63 6b 65 74 70 61 69 72 2c 20 77 72 ┆2): fcntl, read, socketpair, wr┆
0xc20…c40 69 74 65 0a 0a 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 ┆ite December 1990 ┆
0xc40…c60 20 20 20 20 20 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 ┆ TX Programmer's Ref┆
0xc60…c80 65 72 65 6e 63 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 ┆erence ┆
0xc80…c9f 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 ┆ ┆