Bu işlev bir uçbirimin önalan süreç grup kimliğini belirlemede kullanılır. dosyatanıtıcı argümanı uçbirimi belirten bir dosya tanıtıcıdır; pgid ise süreç grubunu belirtir. İşlevi çağıran süreç ile pgid aynı oturumun üyesi olmalı ve aynı denetim uçbirimini kullanıyor olmalıdır.
Uçbirime erişim amaçlarına uygun olarak, bu işlev çıktı olarak kabul edilir. İşlev, denetim uçbiriminin bir artalan sürecinden çağrılmışsa, normalde süreç grubundaki tüm süreçlere bir SIGTTOU sinyali gönderilir. İşlevi çağıran sürecin SIGTTOU sinyalini engellemesi ya da yoksayması durumunda, işlem yine uygulanır ama sinyal gönderilmez.
İşlev başarılı olursa dönüş değeri 0'dır. Dönüş değeri -1 ise bu bir hata oluştuğunu gösterir. Aşağıdaki errno hata durumları bu işlev için tanımlanmıştır:
- EBADF
dosyatanıtıcı argümanı geçerli bir dosya tanıtıcı değil
- EINVAL
pgid argümanı geçersiz
- ENOSYS
Sistem iş denetimini desteklemiyor
- ENOTTY
dosyatanıtıcı argümanı ile ilişkili uçbirim dosyası işlevin çağrıldığı sürecin denetim uçbirimi değil
- EPERM
pgid işlevi çağıran süreçle aynı oturumda değil