unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 setpgid(2)							  setpgid(2)




 NAME
      setpgid(), setpgrp2() - set process group ID for job control

 SYNOPSIS
      #include <&lt&lt&lt;unistd.h>&gt&gt&gt;

      int setpgid(pid_t pid, pid_t pgid);

      int setpgrp2(pid_t pid, pid_t pgid);

 DESCRIPTION
      The setpgid() and setpgrp2() system calls cause the process specified
      by pid to join an existing process group or create a new process group
      within the session of the calling process.  The process group ID of
      the process whose process ID is pid is set to pgid.  If pid is zero,
      the process ID of the calling process is used.  If pgid is zero, the
      process ID of the indicated process is used.  The process group ID of
      a session leader does not change.

      setpgrp2() is provided for backward compatibility only.

 RETURN VALUE
      setpgid() and setpgrp2() return the following values:

	    0	Successful completion.
	   -1	Failure.  errno is set to indicate the error.

 ERRORS
      If setpgid() or setpgrp2() fails, errno is set to one of the following
      values.

	   [EACCES]	  The value of pid matches the process ID of a child
			  process of the calling process and the child
			  process has successfully executed one of the
			  exec(2) functions.

	   [EINVAL]	  The value of pgid is less than zero or is outside
			  the range of valid process group ID values.

	   [EPERM]	  The process indicated by pid is a session leader.

	   [EPERM]	  The value of pid is valid but matches the process
			  ID of a child process of the calling process, and
			  the child process is not in the same session as
			  the calling process.

	   [EPERM]	  The value of pgid does not match the process ID of
			  the process indicated by pid and there is no
			  process with a process group ID that matches the
			  value of pgid in the same session as the calling
			  process.



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 setpgid(2)							  setpgid(2)




	   [ESRCH]	  The value of pid does not match the process ID of
			  the calling process or of a child process of the
			  calling process.

 AUTHOR
      setpgid() and setpgrp2() were developed by HP and the University of
      California, Berkeley.

 SEE ALSO
      bsdproc(3C), exec(2), exit(2), fork(2), getpid(2), kill(2), setsid(2),
      signal(2), termio(7).

 STANDARDS CONFORMANCE
      setpgid(): AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1








































 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000