*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> getsid (2)              



NAME    [Toc]    [Back]

       getsid - Retrieves the session ID of a process

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       pid_t getsid(
               pid_t process_id );

       Application  developers  may  want  to specify an #include
       statement for <sys/types.h> before the one for  <unistd.h>
       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    [Toc]    [Back]

       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 industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       Use the getsid function to retrieve the session ID  for  a
       process.  The  function 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    [Toc]    [Back]

       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    [Toc]    [Back]

       The getsid() function sets errno to the  specified  values
       for  the  following  conditions:  The process_id parameter
       identifies a process that is in a different  session  from
       the calling process.  A process can use the getsid() function
 to get information only about processes  in  its  own
       session.   The system cannot locate the process identified
       by the process_ID parameter.

SEE ALSO    [Toc]    [Back]

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

       Standards:  standards(5)

[ Back ]
 Similar pages
Name OS Title
getsid FreeBSD get process session
getsid OpenBSD get process session
setsid NetBSD create session and set process group ID
setsid OpenBSD create session and set process group ID
setsid HP-UX create session and set process group ID
akill IRIX terminate a process or array session
pxfsetsid IRIX Creates a new session for a calling process
setsid FreeBSD create session and set process group ID
setsid Linux creates a session and sets the process group ID
setpgrp3 HP-UX create session and set process group ID; for HP-UX 9.x compatibility.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service