DataMuseum.dk

top - download

    Length: 2093 (0x82d)
    Names: »setpgrp_tx.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat2/setpgrp_tx.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 73 65 74 70 67 72 70 5f 74 78 28 32 29 0a 0a 0a 0a   ┆s              setpgrp_tx(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 73 65 74 70 67 72 70 5f 74 78 20 2d 20 73 65 74 20 70 72 6f 63 65 73 73 20 67 72 6f 75 70   ┆  setpgrp_tx - set process group┆
0x0a0…0c0 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 08   ┆  S S S SY Y Y YN N N NT T T TA ┆
0x0c0…0e0 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 73 08 73 08 73 08 73 65 08 65 08 65 08 65   ┆A A AX X X X      s s s se e e e┆
0x0e0…100 74 08 74 08 74 08 74 70 08 70 08 70 08 70 67 08 67 08 67 08 67 72 08 72 08 72 08 72 70 08 70 08   ┆t t t tp p p pg g g gr r r rp p ┆
0x100…120 70 08 70 5f 08 5f 08 5f 08 5f 74 08 74 08 74 08 74 78 08 78 08 78 08 78 28 08 28 08 28 08 28 70   ┆p p_ _ _ _t t t tx x x x( ( ( (p┆
0x120…140 08 70 08 70 08 70 69 08 69 08 69 08 69 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 70 08 70 08   ┆ p p pi i i id d d d, , , , p p ┆
0x140…160 70 08 70 67 08 67 08 67 08 67 72 08 72 08 72 08 72 70 08 70 08 70 08 70 29 08 29 08 29 08 29 0a   ┆p pg g g gr r r rp p p p) ) ) ) ┆
0x160…180 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 70 08 70 08 70   ┆     i i i in n n nt t t t p p p┆
0x180…1a0 08 70 69 08 69 08 69 08 69 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 70 08 70 08 70 08 70 67   ┆ pi i i id d d d, , , , p p p pg┆
0x1a0…1c0 08 67 08 67 08 67 72 08 72 08 72 08 72 70 08 70 08 70 08 70 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44   ┆ g g gr r r rp p p p; ; ; ;  D D┆
0x1c0…1e0 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 08 52 08 52   ┆ D DE E E ES S S SC C C CR R R R┆
0x1e0…200 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 4f 08 4f 08   ┆I I I IP P P PT T T TI I I IO O ┆
0x200…220 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 73 5f 08 65 5f 08 74 5f 08 70 5f 08 67 5f   ┆O ON N N N      _ s_ e_ t_ p_ g_┆
0x220…240 08 72 5f 08 70 5f 5f 08 74 5f 08 78 20 73 65 74 73 20 74 68 65 20 70 72 6f 63 65 73 73 20 67 72   ┆ r_ p__ t_ x sets the process gr┆
0x240…260 6f 75 70 20 6f 66 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 70 72 6f 63 65 73 73 0a 20 20 20   ┆oup of the specified process    ┆
0x260…280 20 20 5f 08 70 5f 08 69 5f 08 64 20 74 6f 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 5f 08 70   ┆  _ p_ i_ d to the specified _ p┆
0x280…2a0 5f 08 67 5f 08 72 5f 08 70 2e 0a 0a 20 20 20 20 20 70 08 70 08 70 08 70 69 08 69 08 69 08 69 64   ┆_ g_ r_ p.       p p p pi i i id┆
0x2a0…2c0 08 64 08 64 08 64 20 20 49 66 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 63 61 6c 6c 20 61   ┆ d d d  If zero, then the call a┆
0x2c0…2e0 70 70 6c 69 65 73 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f 63 65 73 73 2e 0a 0a   ┆pplies to the current process.  ┆
0x2e0…300 20 20 20 20 20 70 08 70 08 70 08 70 67 08 67 08 67 08 67 72 08 72 08 72 08 72 70 08 70 08 70 08   ┆     p p p pg g g gr r r rp p p ┆
0x300…320 70 20 4d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 30 20 28 6e 6f 20 67 72 6f 75 70 29 20 6f 72   ┆p Must be either 0 (no group) or┆
0x320…340 20 61 20 76 61 6c 69 64 20 5f 08 70 5f 08 69 5f 08 64 2e 0a 0a 20 20 20 20 20 49 66 20 74 68 65   ┆ a valid _ p_ i_ d.       If the┆
0x340…360 20 63 61 6c 6c 65 72 20 69 73 20 6e 6f 74 20 74 68 65 20 73 75 70 65 72 2d 75 73 65 72 2c 20 74   ┆ caller is not the super-user, t┆
0x360…380 68 65 20 70 72 6f 63 65 73 73 20 6d 75 73 74 20 68 61 76 65 0a 20 20 20 20 20 74 68 65 20 73 61   ┆he process must have      the sa┆
0x380…3a0 6d 65 20 65 66 66 65 63 74 69 76 65 20 75 73 65 72 2d 69 64 20 61 73 20 74 68 65 20 63 61 6c 6c   ┆me effective user-id as the call┆
0x3a0…3c0 65 72 20 6f 72 20 62 65 20 61 20 64 65 73 63 65 6e 64 61 6e 74 0a 20 20 20 20 20 6f 66 20 74 68   ┆er or be a descendant      of th┆
0x3c0…3e0 65 20 69 6e 76 6f 6b 69 6e 67 20 70 72 6f 63 65 73 73 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08   ┆e invoking process.  R R R RE E ┆
0x3e0…400 45 08 45 54 08 54 08 54 08 54 55 08 55 08 55 08 55 52 08 52 08 52 08 52 4e 08 4e 08 4e 08 4e 20   ┆E ET T T TU U U UR R R RN N N N ┆
0x400…420 56 08 56 08 56 08 56 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 55 08 55 08 55 08 55 45 08 45 08   ┆V V V VA A A AL L L LU U U UE E ┆
0x420…440 45 08 45 0a 20 20 20 20 20 5f 08 73 5f 08 65 5f 08 74 5f 08 70 5f 08 67 5f 08 72 5f 08 70 5f 5f   ┆E E      _ s_ e_ t_ p_ g_ r_ p__┆
0x440…460 08 74 5f 08 78 20 72 65 74 75 72 6e 73 20 77 68 65 6e 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e   ┆ t_ x returns when the operation┆
0x460…480 20 77 61 73 20 73 75 63 63 65 73 73 66 75 6c 2e 20 20 49 66 0a 20 20 20 20 20 74 68 65 20 72 65   ┆ was successful.  If      the re┆
0x480…4a0 71 75 65 73 74 20 66 61 69 6c 65 64 2c 20 2d 31 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64   ┆quest failed, -1 is returned and┆
0x4a0…4c0 20 74 68 65 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 0a 20 20 20 20 20 5f 08 65 5f 08 72   ┆ the global variable      _ e_ r┆
0x4c0…4e0 5f 08 72 5f 08 6e 5f 08 6f 20 69 6e 64 69 63 61 74 65 73 20 74 68 65 20 72 65 61 73 6f 6e 2e 0a   ┆_ r_ n_ o indicates the reason. ┆
0x4e0…500 0a 45 08 45 08 45 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   ┆ E E E ER R R RR R R RO O O OR R┆
0x500…520 08 52 08 52 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f 08 73 5f 08 65 5f 08 74 5f 08 70 5f 08 67   ┆ R RS S S S      _ s_ e_ t_ p_ g┆
0x520…540 5f 08 72 5f 08 70 5f 5f 08 74 5f 08 78 20 77 69 6c 6c 20 66 61 69 6c 20 61 6e 64 20 74 68 65 20   ┆_ r_ p__ t_ x will fail and the ┆
0x540…560 70 72 6f 63 65 73 73 20 67 72 6f 75 70 20 77 69 6c 6c 20 6e 6f 74 20 62 65 0a 20 20 20 20 20 61   ┆process group will not be      a┆
0x560…580 6c 74 65 72 65 64 20 69 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f   ┆ltered if one of the following o┆
0x580…5a0 63 63 75 72 73 3a 0a 0a 20 20 20 20 20 5b 45 50 45 52 4d 5d 20 20 20 20 20 20 20 20 54 68 65 20   ┆ccurs:       [EPERM]        The ┆
0x5a0…5c0 65 66 66 65 63 74 69 76 65 20 75 73 65 72 20 49 44 20 6f 66 20 74 68 65 20 72 65 71 75 65 73 74   ┆effective user ID of the request┆
0x5c0…5e0 65 64 20 70 72 6f 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 65 73 73   ┆ed pro-                     cess┆
0x5e0…600 20 69 73 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 61 74 20 6f 66 20 74 68 65 20 63   ┆ is different from that of the c┆
0x600…620 61 6c 6c 65 72 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68   ┆aller and                     th┆
0x620…640 65 20 70 72 6f 63 65 73 73 20 69 73 20 6e 6f 74 20 61 20 64 65 73 63 65 6e 64 65 6e 74 20 6f 66   ┆e process is not a descendent of┆
0x640…660 20 74 68 65 20 63 61 6c 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69   ┆ the cal-                     li┆
0x660…680 6e 67 20 70 72 6f 63 65 73 73 2e 0a 0a 20 20 20 20 20 5b 45 53 52 43 48 5d 20 20 20 20 20 20 20   ┆ng process.       [ESRCH]       ┆
0x680…6a0 20 54 68 65 20 72 65 71 75 65 73 74 65 64 20 70 72 6f 63 65 73 73 20 64 6f 65 73 20 6e 6f 74 20   ┆ The requested process does not ┆
0x6a0…6c0 65 78 69 73 74 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08   ┆exist.  S S S SE E E EE E E E A ┆
0x6c0…6e0 41 08 41 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20   ┆A A AL L L LS S S SO O O O      ┆
0x6e0…700 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 67 65 74 70 67 72 70 2c 20 73 65 74 70 67   ┆System Calls (2): getpgrp, setpg┆
0x700…720 72 70 0a 0a 4e 08 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 54 08 54 08 54 08 54 45 08 45 08 45 08 45   ┆rp  N N N NO O O OT T T TE E E E┆
0x720…740 0a 20 20 20 20 20 54 68 69 73 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 69 73 20 69 64 65 6e 74 69   ┆      This system call is identi┆
0x740…760 63 61 6c 20 74 6f 20 74 68 65 20 5f 08 73 5f 08 65 5f 08 74 5f 08 70 5f 08 67 5f 08 72 5f 08 70   ┆cal to the _ s_ e_ t_ p_ g_ r_ p┆
0x760…780 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 69 6e 0a 20 20 20 20 20 74 68 65 20 42 53 44 20 43 2d 6c   ┆ system call in      the BSD C-l┆
0x780…7a0 69 62 72 61 72 79 20 61 6e 64 20 68 61 73 20 62 65 65 6e 20 72 65 6e 61 6d 65 64 20 74 6f 20 61   ┆ibrary and has been renamed to a┆
0x7a0…7c0 76 6f 69 64 20 61 20 6e 61 6d 65 20 63 6f 6e 2d 0a 20 20 20 20 20 66 6c 69 63 74 20 77 69 74 68   ┆void a name con-      flict with┆
0x7c0…7e0 20 5f 08 73 5f 08 65 5f 08 74 5f 08 70 5f 08 67 5f 08 72 5f 08 70 28 32 29 2e 0a 0a 41 75 67 75   ┆ _ s_ e_ t_ p_ g_ r_ p(2).  Augu┆
0x7e0…800 73 74 20 31 39 39 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆st 1991                         ┆
0x800…820 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 65 0a 0a 0a   ┆    TX Programmer's Reference   ┆
0x820…82d 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                                            ┆             ┆