opensolaris man page for xtsolgetresuid

XTSOLgetResUID(3XTSOL)				 Trusted Extensions to X Windows Library Functions			    XTSOLgetResUID(3XTSOL)

NAME
       XTSOLgetResUID - get the UID associated with a window, a pixmap

SYNOPSIS
       cc [flag...] file... -lX11 -lXtsol [library...]
       #include <X11/extensions/Xtsol.h>

       Status XTSOLgetResUID(display, object, type, uidp);

       Display *display;
       XID object;
       ResourceType type;
       uid_t *uidp;

PARAMETERS
       display	  Specifies a pointer to the Display structure; returned from XOpenDisplay().

       object	  Specifies the ID of a window system object whose UID you want to get. Possible window system objects are windows or pixmaps.

       type	  Specifies what type of resource is being accessed. Possible values are IsWindow and IsPixmap.

       uidp	  Returns a UID which is the current UID of the specified object. Client must provide a pointer to uid_t.

DESCRIPTION
       The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. The XTSOLgetResUID() function retrieves the ownership of a win-
       dow system object. This allows a client to get the ownership of an object that the client did not create.

RETURN VALUES
       None.

ERRORS
       BadAccess    Lack of privilege.

       BadWindow    Not a valid window.

       BadPixmap    Not a valid pixmap.

       BadValue     Not a valid type.

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

       +---------------------------+-------------------------------+
       |      ATTRIBUTE TYPE	   |	    ATTRIBUTE VALUE	   |
       +---------------------------+-------------------------------+
       |Interface Stability	   | Committed			   |
       +---------------------------+-------------------------------+
       |MT-Level		   | Unsafe			   |
       +---------------------------+-------------------------------+

SEE ALSO
       libXtsol(3LIB), XTSOLgetClientAttributes(3XTSOL), XTSOLgetResAttributes(3XTSOL), XTSOLgetResUID(3XTSOL), attributes(5)

       Obtaining the Window User ID in Solaris Trusted Extensions Developer's Guide

NOTES
       The functionality described on this manual page is available only if the system is configured with Trusted Extensions.

SunOS 5.11							    20 Jul 2007 					    XTSOLgetResUID(3XTSOL)