setpgid

Joins or creates a process group for the specified process.

Prototype

int setpgid(int pid, int pgid);

Returns: int

Arguments

Name	Type	Dir	Description
pid	int	-
pgid	int	-

Version history

XNU tag	macOS	#
xnu-1456.1.26	macOS 10.6 Snow Leopard	82
xnu-1699.24.8	macOS 10.7 Lion	82
xnu-2050.18.24	macOS 10.8 Mountain Lion	82
xnu-2422.115.4	macOS 10.9 Mavericks	82
xnu-2782.40.9	macOS 10.10 Yosemite	82
xnu-3247.1.106	macOS 10.11 El Capitan	82
xnu-3789.1.32	macOS 10.12 Sierra	82
xnu-4570.1.46	macOS 10.13 High Sierra	82
xnu-4903.221.2	macOS 10.14 Mojave	82
xnu-6153.11.26	macOS 10.15 Catalina	82
xnu-7195.50.7.100.1	macOS 11.0 Big Sur	82
xnu-8019.41.5	macOS 12.0 Monterey	82
xnu-8792.41.9	macOS 13.0 Ventura	82
xnu-10002.1.13	macOS 14.0 Sonoma	82
xnu-11215.1.10	macOS 15.0 Sequoia	82
xnu-11417.101.15	macOS 15.4 Sequoia	82
xnu-12377.1.9	macOS 26.0 Tahoe	82
xnu-10002.41.9	—	82
xnu-10002.61.3	—	82
xnu-10002.81.5	—	82
xnu-10063.101.15	—	82
xnu-10063.121.3	—	82
xnu-10063.141.1	—	82
xnu-11215.41.3	—	82
xnu-11215.61.5	—	82
xnu-11215.81.4	—	82
xnu-11417.121.6	—	82
xnu-11417.140.69	—	82
xnu-12377.101.15	—	82
xnu-12377.41.6	—	82
xnu-12377.61.12	—	82
xnu-12377.81.4	—	82
xnu-1486.2.11	—	82
xnu-1504.15.3	—	82
xnu-1504.3.12	—	82
xnu-1504.7.4	—	82
xnu-1504.9.17	—	82
xnu-1504.9.26	—	82
xnu-1504.9.37	—	82
xnu-1699.22.73	—	82
xnu-1699.22.81	—	82
xnu-1699.24.23	—	82
xnu-1699.26.8	—	82
xnu-1699.32.7	—	82
xnu-2050.22.13	—	82
xnu-2050.24.15	—	82
xnu-2050.48.11	—	82
xnu-2050.7.9	—	82
xnu-2050.9.2	—	82
xnu-2422.1.72	—	82
xnu-2422.100.13	—	82
xnu-2422.110.17	—	82
xnu-2422.90.20	—	82
xnu-2782.1.97	—	82
xnu-2782.10.72	—	82
xnu-2782.20.48	—	82
xnu-2782.30.5	—	82
xnu-3247.10.11	—	82
xnu-3248.20.55	—	82
xnu-3248.30.4	—	82
xnu-3248.40.184	—	82
xnu-3248.50.21	—	82
xnu-3248.60.10	—	82
xnu-3789.21.4	—	82
xnu-3789.31.2	—	82
xnu-3789.41.3	—	82
xnu-3789.51.2	—	82
xnu-3789.60.24	—	82
xnu-3789.70.16	—	82
xnu-4570.20.62	—	82
xnu-4570.31.3	—	82
xnu-4570.41.2	—	82
xnu-4570.51.1	—	82
xnu-4570.61.1	—	82
xnu-4570.71.2	—	82
xnu-4903.231.4	—	82
xnu-4903.241.1	—	82
xnu-4903.270.47	—	82
xnu-6153.101.6	—	82
xnu-6153.121.1	—	82
xnu-6153.141.1	—	82
xnu-6153.41.3	—	82
xnu-6153.61.1	—	82
xnu-6153.81.5	—	82
xnu-7195.101.1	—	82
xnu-7195.121.3	—	82
xnu-7195.141.2	—	82
xnu-7195.60.75	—	82
xnu-7195.81.3	—	82
xnu-8019.61.5	—	82
xnu-8019.80.24	—	82
xnu-8020.101.4	—	82
xnu-8020.121.3	—	82
xnu-8020.140.41	—	82
xnu-8792.61.2	—	82
xnu-8792.81.2	—	82
xnu-8796.101.5	—	82
xnu-8796.121.2	—	82
xnu-8796.141.3	—	82

Notes

Both arguments may be 0 to operate on the caller and create a new group with PID equal to the caller's PID. Used by shells immediately after fork() so the child is placed in its own pgid before exec, enabling clean job control. The target must be in the same session as the caller and must not have called execve() yet (EACCES).

Related APIs

getpgidgetpgrpsetsidgetsidfork