DataMuseum.dk

top - download

    Length: 2540 (0x9ec)
    Names: »pipe.2«

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

Default Hex Dump

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 70 08 70 08 70 08 70 69 08 69 08 69 08 69 70 08 70 08 70 08 70 65   ┆ X X      p p p pi i i ip p p pe┆
0x100…120 08 65 08 65 08 65 28 08 28 08 28 08 28 66 08 66 08 66 08 66 69 08 69 08 69 08 69 6c 08 6c 08 6c   ┆ e e e( ( ( (f f f fi i i il l l┆
0x120…140 08 6c 64 08 64 08 64 08 64 65 08 65 08 65 08 65 73 08 73 08 73 08 73 29 08 29 08 29 08 29 0a 20   ┆ ld d d de e e es s s s) ) ) )  ┆
0x140…160 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 08 66 08   ┆    i i i in n n nt t t t f f f ┆
0x160…180 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 08 65 08 65 73 08 73   ┆fi i i il l l ld d d de e e es s┆
0x180…1a0 08 73 08 73 5b 08 5b 08 5b 08 5b 32 08 32 08 32 08 32 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b   ┆ s s[ [ [ [2 2 2 2] ] ] ]; ; ; ;┆
0x1a0…1c0 0a 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   ┆  D D D DE E E ES S S SC C C CR ┆
0x1c0…1e0 52 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   ┆R R RI I I IP P P PT T T TI I I ┆
0x1e0…200 49 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 70 5f 08 69 5f   ┆IO O O ON N N N      The _ p_ i_┆
0x200…220 08 70 5f 08 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 63 72 65 61 74 65 73 20 74 68 65 20 49 2f   ┆ p_ e system call creates the I/┆
0x220…240 4f 20 6d 65 63 68 61 6e 69 73 6d 20 63 61 6c 6c 65 64 20 61 0a 20 20 20 20 20 70 69 70 65 2e 20   ┆O mechanism called a      pipe. ┆
0x240…260 20 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 72 65 74 75 72 6e 65 64 20 63   ┆ The file descriptors returned c┆
0x260…280 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 72 65 61 64 20 61 6e 64 0a 20 20 20 20 20 77 72 69 74   ┆an be used in read and      writ┆
0x280…2a0 65 20 6f 70 65 72 61 74 69 6f 6e 73 2e 20 20 57 68 65 6e 20 74 68 65 20 70 69 70 65 20 69 73 20   ┆e operations.  When the pipe is ┆
0x2a0…2c0 77 72 69 74 74 65 6e 20 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 6f   ┆written using the      descripto┆
0x2c0…2e0 72 20 5f 08 66 5f 08 69 5f 08 6c 5f 08 64 5f 08 65 5f 08 73 5b 31 5d 20 75 70 20 74 6f 20 34 30   ┆r _ f_ i_ l_ d_ e_ s[1] up to 40┆
0x2e0…300 39 36 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 61 72 65 20 62 75 66 66 65 72 65 64 0a 20 20   ┆96 bytes of data are buffered   ┆
0x300…320 20 20 20 62 65 66 6f 72 65 20 74 68 65 20 77 72 69 74 69 6e 67 20 70 72 6f 63 65 73 73 20 69 73   ┆   before the writing process is┆
0x320…340 20 73 75 73 70 65 6e 64 65 64 2e 20 20 41 20 72 65 61 64 20 75 73 69 6e 67 20 74 68 65 0a 20 20   ┆ suspended.  A read using the   ┆
0x340…360 20 20 20 64 65 73 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   ┆   descriptor _ f_ i_ l_ d_ e_ s┆
0x360…380 5b 30 5d 20 77 69 6c 6c 20 70 69 63 6b 20 75 70 20 74 68 65 20 64 61 74 61 2e 0a 0a 20 20 20 20   ┆[0] will pick up the data.      ┆
0x380…3a0 20 41 66 74 65 72 20 74 68 65 20 70 69 70 65 20 68 61 73 20 62 65 65 6e 20 73 65 74 20 75 70 2c   ┆ After the pipe has been set up,┆
0x3a0…3c0 20 74 77 6f 20 28 6f 72 20 6d 6f 72 65 29 20 63 6f 6f 70 65 72 61 74 69 6e 67 0a 20 20 20 20 20   ┆ two (or more) cooperating      ┆
0x3c0…3e0 70 72 6f 63 65 73 73 65 73 20 28 63 72 65 61 74 65 64 20 62 79 20 73 75 62 73 65 71 75 65 6e 74   ┆processes (created by subsequent┆
0x3e0…400 20 5f 08 66 5f 08 6f 5f 08 72 5f 08 6b 20 63 61 6c 6c 73 29 20 63 61 6e 20 70 61 73 73 20 64 61   ┆ _ f_ o_ r_ k calls) can pass da┆
0x400…420 74 61 0a 20 20 20 20 20 74 68 72 6f 75 67 68 20 74 68 65 20 70 69 70 65 20 77 69 74 68 20 5f 08   ┆ta      through the pipe with _ ┆
0x420…440 72 5f 08 65 5f 08 61 5f 08 64 20 61 6e 64 20 5f 08 77 5f 08 72 5f 08 69 5f 08 74 5f 08 65 20 63   ┆r_ e_ a_ d and _ w_ r_ i_ t_ e c┆
0x440…460 61 6c 6c 73 2e 0a 0a 20 20 20 20 20 54 68 65 20 73 68 65 6c 6c 20 68 61 73 20 61 20 73 79 6e 74   ┆alls.       The shell has a synt┆
0x460…480 61 78 20 74 6f 20 73 65 74 20 75 70 20 61 20 6c 69 6e 65 61 72 20 61 72 72 61 79 20 6f 66 20 70   ┆ax to set up a linear array of p┆
0x480…4a0 72 6f 63 65 73 73 65 73 0a 20 20 20 20 20 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 70 69 70 65 73   ┆rocesses      connected by pipes┆
0x4a0…4c0 2e 0a 0a 20 20 20 20 20 50 69 70 65 73 20 61 72 65 20 73 70 65 63 69 61 6c 20 54 58 49 50 43 20   ┆.       Pipes are special TXIPC ┆
0x4c0…4e0 63 68 61 6e 6e 65 6c 73 2e 0a 0a 20 20 20 20 20 45 08 45 08 45 08 45 6d 08 6d 08 6d 08 6d 70 08   ┆channels.       E E E Em m m mp ┆
0x4e0…500 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 69 08 69 08 69   ┆p p pt t t ty y y y P P P Pi i i┆
0x500…520 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 20 20 41 20 70   ┆ ip p p pe e e es s s s      A p┆
0x520…540 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 69 74 20 68 61   ┆ipe is considered empty if it ha┆
0x540…560 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 5f 08 61 5f 08   ┆s no buffered data.  _ r_ e_ a_ ┆
0x560…580 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 70 65 20 77 69   ┆d      calls on an empty pipe wi┆
0x580…5a0 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 66 69 6c 65 0a   ┆th only one end (all write file ┆
0x5a0…5c0 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 74 75 72 6e 73   ┆     descriptors closed) returns┆
0x5c0…5e0 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 69 73 0a 20 20   ┆ an end-of-file.  A signal is   ┆
0x5e0…600 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 61 20 70 69 70   ┆   generated if a write on a pip┆
0x600…620 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 20 61 74 74 65   ┆e with only one end is      atte┆
0x620…640 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 6c 08 6c 08 6c   ┆mpted.       M M M Mu u u ul l l┆
0x640…660 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 50 08 50 55 08   ┆ lt t t ti i i i- - - -P P P PU ┆
0x660…680 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 74 08 74 08 74   ┆U U U S S S Sy y y ys s s st t t┆
0x680…6a0 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 20 20 50 69 70   ┆ te e e em m m ms s s s      Pip┆
0x6a0…6c0 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 6e 20 6f 6e 65   ┆es are effective only within one┆
0x6c0…6e0 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 55 08 55 08 55   ┆ PU.  R R R RE E E ET T T TU U U┆
0x6e0…700 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 08 41 4c   ┆ UR R R RN N N N V V V VA A A AL┆
0x700…720 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 68 65 20 66 75   ┆ L L LU U U UE E E E      The fu┆
0x720…740 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 65 64 20 69 66   ┆nction value zero is returned if┆
0x740…760 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 20 2d 31 20 69   ┆ the pipe was created;      -1 i┆
0x760…780 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 08 45 52 08 52   ┆f an error occurred.  E E E ER R┆
0x780…7a0 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 53 08 53 08 53   ┆ R RR R R RO O O OR R R RS S S S┆
0x7a0…7c0 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 20 77 69 6c 6c   ┆      The _ p_ i_ p_ e call will┆
0x7c0…7e0 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 20 20 20 20 54   ┆ fail if:       [EFAULT]       T┆
0x7e0…800 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 72 20 69 73 20   ┆he _ f_ i_ l_ d_ e_ s buffer is ┆
0x800…820 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 20 20 20 20 20   ┆in an invalid area of           ┆
0x820…840 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 72 65 73 73 20   ┆          the process's address ┆
0x840…860 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 20 54 6f 6f 20   ┆space.       [EMFILE]       Too ┆
0x860…880 6d 61 6e 79 20 64 65 73 63 72 69 70 74 6f 72 73 20 61 72 65 20 61 63 74 69 76 65 2e 0a 0a 53 08   ┆many descriptors are active.  S ┆
0x880…8a0 53 08 53 08 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   ┆S S SE E E EE E E E A A A AL L L┆
0x8a0…8c0 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 55 73 65 72 20 43 6f 6d 6d 61   ┆ LS S S SO O O O      User Comma┆
0x8c0…8e0 6e 64 73 20 28 31 29 3a 20 20 73 68 0a 20 20 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28   ┆nds (1):  sh      System Calls (┆
0x8e0…900 32 29 3a 20 20 72 65 61 64 2c 20 66 6f 72 6b 2c 20 6f 70 65 6e 2c 20 73 6f 63 6b 65 74 70 61 69   ┆2):  read, fork, open, socketpai┆
0x900…920 72 2c 20 77 72 69 74 65 0a 0a 4c 08 4c 08 4c 08 4c 49 08 49 08 49 08 49 4d 08 4d 08 4d 08 4d 49   ┆r, write  L L L LI I I IM M M MI┆
0x920…940 08 49 08 49 08 49 54 08 54 08 54 08 54 41 08 41 08 41 08 41 54 08 54 08 54 08 54 49 08 49 08 49   ┆ I I IT T T TA A A AT T T TI I I┆
0x940…960 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 53 08 53 08 53 08 53 0a 20 20 20 20 20 44 65 61   ┆ IO O O ON N N NS S S S      Dea┆
0x960…980 64 6c 6f 63 6b 73 20 6d 61 79 20 6f 63 63 75 72 20 69 66 20 74 68 65 20 73 79 73 74 65 6d 27 73   ┆dlocks may occur if the system's┆
0x980…9a0 20 62 75 66 66 65 72 69 6e 67 20 6c 69 6d 69 74 73 20 61 72 65 0a 20 20 20 20 20 65 78 63 65 65   ┆ buffering limits are      excee┆
0x9a0…9c0 64 65 64 2e 0a 0a 44 65 63 65 6d 62 65 72 20 31 39 38 39 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆ded.  December 1989             ┆
0x9c0…9e0 20 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   ┆              TX Programmer's Re┆
0x9e0…9ec 66 65 72 65 6e 63 65 0a 0a 0a 0a 0a                                                               ┆ference     ┆