gong(1) [linux man page]

GONG(1) 						      General Commands Manual							   GONG(1)

NAME

       gong - evaluate process performance

SYNOPSIS

       gong [-f] [-a] process-id

DESCRIPTION

       Gong is used to evaluate the performance of a process that is in execution.

       The  process-id	is  the process number of the process whose performance is to be evaluated.  The evaluation is performed by a set of three
       ``panelist'' routines, each of which analyzes one aspect (time, space, and tonality) of the performance of the process.	If  any  of  these
       routines is not amused by the performance, the process being analyzed is sent the gong(2) signal.  In addition, the process-id of the eval-
       uated process is written on the standard gong, for possible future corrective action.  (It is suggested that the standard gong be an  audi-
       ble alarm for proper effect.)  It is expected that after being gong(2)ed, the process will promptly commit suicide.

       The  -f	keyletter  argument  indicates	that  gong  is	to  invoke flog(1) with the unmerciful argument if the process does not respond to
       gong(2)ing.  In the absence of this argument, the process is continuously gong(2)ed, which may lead to the process becoming a deaf zombie.

       The -a keyletter argument indicates that if all three of the panelist routines gong(2)  a  process,  the  process  should  be  unmercifully
       flog(1)ged whether or not the -f keyletter is supplied.

FILES

       /dev/ding.dong is the standard gong.

SEE ALSO

       On  the	Applicability  of  Gonging to the Performance and Merit Review Process, Journal of Irreproducible Results, vol. 263, issue 19, pp.
       253-307.

BUGS

       If the named process does not exist, it is possible that gong will attempt an evaluation of itself, which may lead to a condition known	as
       compounded double ringing (see echo(1)).  Therefore, it is recommended that gong be used with extreme care.

																	   GONG(1)

setpgid(3)						     Library Functions Manual							setpgid(3)

Name
       setpgid - set process group (POSIX)

Syntax
       #include <sys/types.h>
       int
       setpgid(pid, pgrp)
       pid_t pid, pgrp;

Description
       The  function is used to either join an existing process group or create a new process group within the session of the calling process (see
       Upon successful completion, the process group ID of the process that has a process ID which matches pid is set to pgrp.	If  pid  is  zero,
       then the call applies to the current process. In addition, if pgrp is zero, the process ID of the indicated process is used.

       This function is available only in the POSIX environment.

Return Values
       The  function  returns 0 when the operation is successful.  If the request fails, -1 is returned and the global variable indicates the rea-
       son.

Diagnostics
       The function fails and the process group is not altered if one of the following occurs:

       [EACCES]       The value of the pid argument matches the process ID of a child process of the calling process and  the  child  process  has
		      successfully executed an function.

       [EINVAL]       The value of the pgrp argument is less than zero or is not a supported value.

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

		      The  value of the pid argument 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.

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

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

See Also
       getpgrp(2), setsid(2)

																	setpgid(3)