diff options
Diffstat (limited to 'reference/C/MAN/getpgrp.htm')
| -rw-r--r-- | reference/C/MAN/getpgrp.htm | 166 |
1 files changed, 166 insertions, 0 deletions
diff --git a/reference/C/MAN/getpgrp.htm b/reference/C/MAN/getpgrp.htm new file mode 100644 index 0000000..7d56e00 --- /dev/null +++ b/reference/C/MAN/getpgrp.htm @@ -0,0 +1,166 @@ +<TITLE>getpgrp</TITLE> +<body bgcolor="#ffffcc"> +<hr> +<pre> + + + +<h3>SETPGID(2) Linux Programmer's Manual SETPGID(2) +</h3> + +<h3>NAME +</h3> setpgid, getpgid, setpgrp, getpgrp - set/get process group + +<h3>SYNOPSIS +</h3> #include <unistd.h> + + int setpgid(pid_t pid, pid_t pgid); + pid_t getpgid(pid_t pid); + int setpgrp(void); + pid_t getpgrp(void); + +<h3>DESCRIPTION +</h3> setpgid sets the process group ID of the process specified + by pid to pgid. If pid is zero, the process ID of the + current process is used. If pgid is zero, the process ID + of the process specified by pid is used. + + getpgid returns the process group ID of the process speci- + fied by pid. If pid is zero, the process ID of the cur- + rent process is used. + + In the Linux DLL 4.4.1 library, setpgrp simply calls + setpgid(0,0). + + getpgrp is equivalent to getpgid(0). + + Process groups are used for distribution of signals, and + by terminals to arbitrate requests for their input: pro- + cesses that have the same process group as the terminal + are foreground and may read, while others will block with + a signal if they attempt to read. + + These calls are thus used by programs such as csh(1) to + create process groups in implementing job control. The + TIOCGPGRP and TIOCSPGRP calls described in termios(4) are + used to get/set the process group of the control terminal. + +<h3>RETURN VALUE +</h3> On success, setpgid and setpgrp return zero. On error, -1 + is returned, and errno is set appropriately. + + getpgid returns a process group on success. On error, -1 + is returned, and errno is set appropriately. + + getpgrp always returns the current process group. + +<h3>ERRORS +</h3> EINVAL pgid is less than 0. + + EPERM Various permission violations. + + ESRCH pid does not match any process. + + + + + +<h3>Linux 1.2.4 15 April 1995 1 +</h3> + + + + +<h3>SETPGID(2) Linux Programmer's Manual SETPGID(2) +</h3> + +</pre> +<hr> +<h3>SEE ALSO +</h3><p> +<a href=getuid.htm>getuid</a>, +<a href=setsid.htm>setsid</a>, +<a href=tcsetpgrp.htm>tcsetpgrp</a>, +<a href=termios+4>termios</a>, +<pre> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +<h3>Linux 1.2.4 15 April 1995 2 +</h3> + +
</pre> +<P> +<hr> +<p> +<center> +<table border=2 width=80%> +<tr align=center> +<td width=25%> +<a href=../cref.html>Top</a> +</td><td width=25%> +<a href=../master_index.html>Master Index</a> +</td><td width=25%> +<a href=../SYNTAX/keywords.html>Keywords</a> +</td><td width=25%> +<a href=../FUNCTIONS/funcref.htm>Functions</a> +</td> +</tr> +</table> +</center> +<p> +<hr> + +This manual page was brought to you by <i>mjl_man V-2.0</i> |