unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



getsid(2)							    getsid(2)



NAME

  getsid - Retrieves the session ID of a process

SYNOPSIS

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


  pid_t	getsid(
	  pid_t	process_id );

  Application developers may want to specify an	#include statement for
  <&lt;sys/types.h>&gt;	before the one for <&lt;unistd.h>&gt; if programs are being developed
  for multiple platforms. The additional #include statement is not required
  on Tru64 UNIX	systems	or by ISO or X/Open standards, but may be required on
  other	vendors' systems that conform to these standards.

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  getsid():  XPG4-UNIX

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

PARAMETERS

  process_id
      Specifies	the process ID that identifies the process for which you want
      to retrieve a session ID.

DESCRIPTION

  Use the getsid function to retrieve the session ID for a process. The	func-
  tion returns the session ID assigned to the process identified in the
  process_id parameter.	 If you	specify	0 (zero) in the	process_id parameter,
  the getsid function returns the session ID of	the calling process.

RETURN VALUES

  Upon successful completion, the getsid() function returns the	session	ID of
  the process identified by the	process_id parameter. Otherwise, the function
  returns -1 and sets errno to indicate	the error.








ERRORS

  The getsid() function	sets errno to the specified values for the following
  conditions:

  [EPERM]
      The process_id parameter identifies a process that is in a different
      session from the calling process.	 A process can use the getsid()	func-
      tion to get information only about processes in its own session.

  [ESRCH]
      The system cannot	locate the process identified by the process_ID
      parameter.

SEE ALSO

  Functions:  exec(2), fork(2),	getpid(2), setpgid(2), setsid(2)

  Standards:  standards(5)