DataMuseum.dk

top - download

    Length: 2920 (0xb68)
    Names: »setpgid.3«

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

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 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x040…060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 74 70 67 69 64 28 33 29 0a 0a 0a 0a   ┆ions              setpgid(3)    ┆
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 69 64 20 2d 20 73 65 74 20 70 72 6f 63 65 73 73 20 67 72 6f 75 70 20 49 44   ┆  setpgid - set process group ID┆
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 23 08 23 08 23 08 23 69 08 69 08 69 08 69   ┆A A AX X X X      # # # #i i i i┆
0x0e0…100 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 08   ┆n n n nc c c cl l l lu u u ud d ┆
0x100…120 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 79   ┆d de e e e < < < <s s s sy y y y┆
0x120…140 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 08   ┆s s s s/ / / /t t t ty y y yp p ┆
0x140…160 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 3e   ┆p pe e e es s s s. . . .h h h h>┆
0x160…180 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 08 74 08 74   ┆ > > >       i i i in n n nt t t┆
0x180…1a0 08 74 20 73 08 73 08 73 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 70 08 70 08 70 08 70 67   ┆ t s s s se e e et t t tp p p pg┆
0x1a0…1c0 08 67 08 67 08 67 69 08 69 08 69 08 69 64 08 64 08 64 08 64 28 08 28 08 28 08 28 70 08 70 08 70   ┆ g g gi i i id d d d( ( ( (p p p┆
0x1c0…1e0 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┆
0x1e0…200 08 67 08 67 08 67 69 08 69 08 69 08 69 64 08 64 08 64 08 64 29 08 29 08 29 08 29 0a 20 20 20 20   ┆ g g gi i i id d d d) ) ) )     ┆
0x200…220 20 70 08 70 08 70 08 70 69 08 69 08 69 08 69 64 08 64 08 64 08 64 5f 08 5f 08 5f 08 5f 74 08 74   ┆ p p p pi i i id d d d_ _ _ _t t┆
0x220…240 08 74 08 74 20 70 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   ┆ t t p p p pi i i id d d d, , , ┆
0x240…260 2c 20 70 08 70 08 70 08 70 67 08 67 08 67 08 67 69 08 69 08 69 08 69 64 08 64 08 64 08 64 3b 08   ┆, p p p pg g g gi i i id d d d; ┆
0x260…280 3b 08 3b 08 3b 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   ┆; ; ;  D D D DE E E ES S S SC C ┆
0x280…2a0 43 08 43 52 08 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   ┆C CR R R RI I I IP P P PT T T TI┆
0x2a0…2c0 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 73 5f 08 65   ┆ I I IO O O ON N N N      _ s_ e┆
0x2c0…2e0 5f 08 74 5f 08 70 5f 08 67 5f 08 69 5f 08 64 20 73 65 74 73 20 74 68 65 20 70 72 6f 63 65 73 73   ┆_ t_ p_ g_ i_ d sets the process┆
0x2e0…300 20 67 72 6f 75 70 20 49 44 20 6f 66 20 74 68 65 20 70 72 6f 63 65 73 73 20 77 69 74 68 20 49 44   ┆ group ID of the process with ID┆
0x300…320 20 5f 08 70 5f 08 69 5f 08 64 0a 20 20 20 20 20 74 6f 20 5f 08 70 5f 08 67 5f 08 69 5f 08 64 2e   ┆ _ p_ i_ d      to _ p_ g_ i_ d.┆
0x320…340 20 20 49 66 20 5f 08 70 5f 08 67 5f 08 69 5f 08 64 20 69 73 20 65 71 75 61 6c 20 74 6f 20 5f 08   ┆  If _ p_ g_ i_ d is equal to _ ┆
0x340…360 70 5f 08 69 5f 08 64 2c 20 20 74 68 65 20 70 72 6f 63 65 73 73 20 62 65 63 6f 6d 65 73 20 61 0a   ┆p_ i_ d,  the process becomes a ┆
0x360…380 20 20 20 20 20 70 72 6f 63 65 73 73 20 67 72 6f 75 70 20 6c 65 61 64 65 72 2e 20 49 66 20 5f 08   ┆     process group leader. If _ ┆
0x380…3a0 70 5f 08 67 5f 08 69 5f 08 64 20 69 73 20 6e 6f 74 20 65 71 75 61 6c 20 74 6f 20 5f 08 70 5f 08   ┆p_ g_ i_ d is not equal to _ p_ ┆
0x3a0…3c0 69 5f 08 64 2c 20 74 68 65 20 70 72 6f 2d 0a 20 20 20 20 20 63 65 73 73 20 62 65 63 6f 6d 65 73   ┆i_ d, the pro-      cess becomes┆
0x3c0…3e0 20 61 20 6d 65 6d 62 65 72 20 6f 66 20 61 6e 20 65 78 69 73 74 69 6e 67 20 70 72 6f 63 65 73 73   ┆ a member of an existing process┆
0x3e0…400 20 67 72 6f 75 70 2e 0a 0a 20 20 20 20 20 49 66 20 5f 08 70 5f 08 69 5f 08 64 20 69 73 20 65 71   ┆ group.       If _ p_ i_ d is eq┆
0x400…420 75 61 6c 20 74 6f 20 30 2c 20 74 68 65 20 70 72 6f 63 65 73 73 20 49 44 20 6f 66 20 74 68 65 20   ┆ual to 0, the process ID of the ┆
0x420…440 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 0a 20 20 20 20 20 69 73 20 75 73 65 64 2e 20 20 49   ┆calling process      is used.  I┆
0x440…460 66 20 5f 08 70 5f 08 67 5f 08 69 5f 08 64 20 69 73 20 65 71 75 61 6c 20 74 6f 20 30 2c 20 74 68   ┆f _ p_ g_ i_ d is equal to 0, th┆
0x460…480 65 20 70 72 6f 63 65 73 73 20 73 70 65 63 69 66 69 65 64 20 62 79 0a 20 20 20 20 20 5f 08 70 5f   ┆e process specified by      _ p_┆
0x480…4a0 08 69 5f 08 64 20 62 65 63 6f 6d 65 73 20 61 20 70 72 6f 63 65 73 73 20 67 72 6f 75 70 20 6c 65   ┆ i_ d becomes a process group le┆
0x4a0…4c0 61 64 65 72 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   ┆ader.  R R R RE E E ET T T TU U ┆
0x4c0…4e0 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 08 41   ┆U UR R R RN N N N V V V VA A A A┆
0x4e0…500 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 6e 20   ┆L L L LU U U UE E E E      Upon ┆
0x500…520 73 75 63 63 65 73 73 66 75 6c 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 5f 08 73 5f 08 65 5f 08 74   ┆successful completion, _ s_ e_ t┆
0x520…540 5f 08 70 5f 08 67 5f 08 69 5f 08 64 20 72 65 74 75 72 6e 73 20 61 20 76 61 6c 75 65 20 6f 66 20   ┆_ p_ g_ i_ d returns a value of ┆
0x540…560 30 2e 0a 20 20 20 20 20 4f 74 68 65 72 77 69 73 65 2c 20 61 20 76 61 6c 75 65 20 6f 66 20 2d 31   ┆0.      Otherwise, a value of -1┆
0x560…580 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 6f   ┆ is returned and _ e_ r_ r_ n_ o┆
0x580…5a0 20 69 73 20 73 65 74 20 74 6f 0a 20 20 20 20 20 69 6e 64 69 63 61 74 65 20 74 68 65 20 65 72 72   ┆ is set to      indicate the err┆
0x5a0…5c0 6f 72 2e 0a 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   ┆or.  E E E ER R R RR R R RO O O ┆
0x5c0…5e0 4f 52 08 52 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   ┆OR R R RS S S S      _ s_ e_ t_ ┆
0x5e0…600 70 5f 08 67 5f 08 69 5f 08 64 20 66 61 69 6c 73 20 69 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20   ┆p_ g_ i_ d fails if one or more ┆
0x600…620 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 0a 20 20 20 20   ┆of the following are true:      ┆
0x620…640 20 5b 45 41 43 43 45 53 5d 20 20 20 20 20 20 20 5f 08 70 5f 08 69 5f 08 64 20 6d 61 74 63 68 65   ┆ [EACCES]       _ p_ i_ d matche┆
0x640…660 73 20 74 68 65 20 70 72 6f 63 65 73 73 20 49 44 20 6f 66 20 61 20 63 68 69 6c 64 20 70 72 6f 63   ┆s the process ID of a child proc┆
0x660…680 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 63   ┆ess                     of the c┆
0x680…6a0 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 20 61 6e 64 20 74 68 65 20 63 68 69 6c 64 20 70 72 6f   ┆alling process and the child pro┆
0x6a0…6c0 63 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 68 61 73 20 73 75 63   ┆cess                     has suc┆
0x6c0…6e0 63 65 73 73 66 75 6c 6c 79 20 65 78 65 63 75 74 65 64 20 61 6e 20 5f 08 65 5f 08 78 5f 08 65 5f   ┆cessfully executed an _ e_ x_ e_┆
0x6e0…700 08 63 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 5b 45 49 4e 56 41 4c 5d 20 20 20 20 20   ┆ c function.       [EINVAL]     ┆
0x700…720 20 20 5f 08 70 5f 08 67 5f 08 69 5f 08 64 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 28 70 08 70   ┆  _ p_ g_ i_ d is less than (p p┆
0x720…740 08 70 08 70 69 08 69 08 69 08 69 64 08 64 08 64 08 64 5f 08 5f 08 5f 08 5f 74 08 74 08 74 08 74   ┆ p pi i i id d d d_ _ _ _t t t t┆
0x740…760 29 20 30 2c 20 6f 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 0a 20 20 20 20 20 20 20 20 20 20 20   ┆) 0, or greater than            ┆
0x760…780 20 20 20 20 20 20 20 20 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 7b 50 49 44 5f 4d 41 58 7d 2e 0a   ┆         or equal to {PID_MAX}. ┆
0x780…7a0 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 70 72 6f 63 65 73 73   ┆      [EPERM]        The process┆
0x7a0…7c0 20 69 6e 64 69 63 61 74 65 64 20 62 79 20 74 68 65 20 5f 08 70 5f 08 69 5f 08 64 20 61 72 67 75   ┆ indicated by the _ p_ i_ d argu┆
0x7c0…7e0 6d 65 6e 74 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 20 73 65   ┆ment is                     a se┆
0x7e0…800 73 73 69 6f 6e 20 6c 65 61 64 65 72 3b 20 6f 72 20 5f 08 70 5f 08 69 5f 08 64 20 6d 61 74 63 68   ┆ssion leader; or _ p_ i_ d match┆
0x800…820 65 73 20 74 68 65 20 70 72 6f 63 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆es the process                  ┆
0x820…840 20 20 20 49 44 20 6f 66 20 61 20 63 68 69 6c 64 20 70 72 6f 63 65 73 73 20 6f 66 20 74 68 65 20   ┆   ID of a child process of the ┆
0x840…860 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆calling process                 ┆
0x860…880 20 20 20 20 61 6e 64 20 74 68 65 20 63 68 69 6c 64 20 70 72 6f 63 65 73 73 20 69 73 20 6e 6f 74   ┆    and the child process is not┆
0x880…8a0 20 69 6e 20 74 68 65 20 73 61 6d 65 20 73 65 73 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆ in the same ses-               ┆
0x8a0…8c0 20 20 20 20 20 20 73 69 6f 6e 20 61 73 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73   ┆      sion as the calling proces┆
0x8c0…8e0 73 3b 20 6f 72 20 5f 08 70 5f 08 67 5f 08 69 5f 08 64 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20   ┆s; or _ p_ g_ i_ d does not     ┆
0x8e0…900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 61 74 63 68 20 74 68 65 20 70 72 6f 63 65 73   ┆                match the proces┆
0x900…920 73 20 49 44 20 6f 66 20 74 68 65 20 70 72 6f 63 65 73 73 20 69 6e 64 69 63 61 74 65 64 0a 20 20   ┆s ID of the process indicated   ┆
0x920…940 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 79 20 74 68 65 20 5f 08 70 5f 08 69 5f   ┆                  by the _ p_ i_┆
0x940…960 08 64 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 72 6f 63   ┆ d argument and there is no proc┆
0x960…980 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 20 61 20 70   ┆ess                     with a p┆
0x980…9a0 72 6f 63 65 73 73 20 67 72 6f 75 70 20 49 44 20 74 68 61 74 20 6d 61 74 63 68 65 73 20 5f 08 70   ┆rocess group ID that matches _ p┆
0x9a0…9c0 5f 08 67 5f 08 69 5f 08 64 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆_ g_ i_ d in                    ┆
0x9c0…9e0 20 74 68 65 20 73 61 6d 65 20 73 65 73 73 69 6f 6e 20 61 73 20 74 68 65 20 63 61 6c 6c 69 6e 67   ┆ the same session as the calling┆
0x9e0…a00 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 20 5f   ┆ process.       [ESRCH]        _┆
0xa00…a20 08 70 5f 08 69 5f 08 64 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 20 70 72 6f 63   ┆ p_ i_ d does not match the proc┆
0xa20…a40 65 73 73 20 49 44 20 6f 66 20 74 68 65 20 63 61 6c 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆ess ID of the cal-              ┆
0xa40…a60 20 20 20 20 20 20 20 6c 69 6e 67 20 70 72 6f 63 65 73 73 20 6f 72 20 6f 66 20 61 20 63 68 69 6c   ┆       ling process or of a chil┆
0xa60…a80 64 20 70 72 6f 63 65 73 73 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆d process of the                ┆
0xa80…aa0 20 20 20 20 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 2e 0a 0a 53 08 53 08 53 08 53 45 08   ┆     calling process.  S S S SE ┆
0xaa0…ac0 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 53 08 53   ┆E E EE E E E A A A AL L L LS S S┆
0xac0…ae0 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 32 29 3a   ┆ SO O O O      System Calls (2):┆
0xae0…b00 20 65 78 65 63 76 65 2c 20 67 65 74 70 67 72 70 0a 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75   ┆ execve, getpgrp      Library Fu┆
0xb00…b20 6e 63 74 69 6f 6e 73 20 28 33 29 3a 20 73 65 74 73 69 64 2c 20 74 63 73 65 74 70 67 72 70 0a 0a   ┆nctions (3): setsid, tcsetpgrp  ┆
0xb20…b40 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                   ┆
0xb40…b60 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┆
0xb60…b68 65 0a 0a 0a 0a 0a 0a 0a                                                                           ┆e       ┆