pm_get_sid_txt()

PM_$GET_SID_TXT                   Domain/OS                    PM_$GET_SID_TXT


NAME
     pm_$get_sid_txt - get the SID

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pm.h>

     void pm_$get_sid_txt(
          short &buffer_length,
          char *sid,
          short *sid_length);

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pm.ins.pas';

     procedure pm_$get_sid_txt(
          in buffer_length: integer;
          out sid: univ pm_$sidtext_t;
          out sid_length: integer);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pm.ins.ftn'

           integer*2 buffer_length, sid_length
           character sid*140

           call pm_$get_sid_txt(buffer_length, sid, sid_length)

DESCRIPTION
     Pm_$get_sid_txt supplies the SID for the calling process in sid.  A SID
     is a key to the permissions granted to a process, and has the form
     "PERSON.GROUP.ORGANIZATION", where PERSON is the login of the owner of
     the process, GROUP is the process owner's current group, and ORGANIZATION
     is the process owner's current organization or "project."

     buffer_length
          The number of bytes in the buffer allocated to receive the SID.
          Pm_$get_sid_txt will not write more than buffer_length characters
          into sid.

     sid  The SID for the calling process.

     sid_length
          The number of bytes in the SID of the calling process.  If the value
          supplied in sid_length equals or exceeds the value passed in
          buffer_length, then the SID string written in sid might be trun-
          cated.
Museum
