Manual Pages for UNIX Operating System command usage for man Ucred

Perl Library Functions                               Ucred(3PERL)



NAME
     Ucred - Perl interface to User Credentials

SYNOPSIS
     use Sun::Solaris::Ucred qw(:ALL);


DESCRIPTION
     This module provides wrappers for the  Ucred-related  system
     and library calls.

  Constants
     None.

  Functions
     ucred_get($pid)

         This function returns  the  credential  of  the  process
         specified  by $pid if the process exists and the calling
         process is permitted to obtain the credentials  of  that
         process.


     getpeerucred($fd)

         If $fd is a connected connection-oriented TLI  endpoint,
         a  connected  SOCK_STREAM, or a SOCK_SEQPKT socket, get-
         peerucred() returns the user credential of the  peer  at
         the time the connection was established, if availble.


     ucred_geteuid($ucred)

         This function  returns  the  effective  uid  of  a  user
         credential, if available.


     ucred_getruid($ucred)

         This function returns the real uid of a user credential,
         if available.


     ucred_getsuid($ucred)

         This function returns the saved uid of  a  user  creden-
         tial, if available.


     ucred_getegid($ucred)

         This function returns the  effective  group  of  a  user



SunOS 5.11          Last change: 30 Jan 2004                    1






Perl Library Functions                               Ucred(3PERL)



         credential, if available.


     ucred_getrgid($ucred)

         This function returns the real group of a  user  creden-
         tial, if available.


     ucred_getsgid($ucred)

         This function returns the saved group of a user  creden-
         tial, if available.


     ucred_getgroups($ucred)

         This function returns the list of supplemental groups of
         a  user  credential,  if available.An array of groups is
         returned in ARRAY  context;  the  number  of  groups  is
         returned in SCALAR context.


     ucred_getprivset($ucred, $which)

         This function returns the  privilege  set  specified  by
         $which of a user credential, if available.


     ucred_getpflags($ucred, $flags)

         This function returns the value of  a  specific  process
         flag of a user credential, if available.


     ucred_getpid($ucred)

         This function returns the process ID of a  user  creden-
         tial, if available.


     ucred_getprojid($ucred)

         This function returns the project ID of a  user  creden-
         tial, if available.


     ucred_getzoneid($ucred)

         This function returns the zone ID of a user  credential,
         if available.




SunOS 5.11          Last change: 30 Jan 2004                    2






Perl Library Functions                               Ucred(3PERL)



  Class methods
     None.

  Object methods
     None.

  Exports
     By default nothing is exported from this module. The follow-
     ing  tags  can  be  used to selectively import constants and
     functions defined in this module:

     :SYSCALLS    ucred_get(), getpeerucred()


     :LIBCALLS    ucred_geteuid(),               ucred_getruid(),
                  ucred_getsuid(),               ucred_getegid(),
                  ucred_getrgid(),               ucred_getsgid(),
                  ucred_getgroups(),          ucred_getprivset(),
                  ucred_getpflags(),              ucred_getpid(),
                  ucred_getzone()


     :ALL         :SYSCALLS(), :LIBCALLS()


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpl5u                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     getpeerucred(3C), ucred_get(3C), attributes(5)













SunOS 5.11          Last change: 30 Jan 2004                    3