opensolaris man page for xtsolsetresuid

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

NAME
       XTSOLsetResUID - set the UID associated with a window, a pixmap, or a colormap

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

       Status XTSOLsetResUID(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 change. Possible window system objects are windows and pixmaps.

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

       uidp	  Specifies a pointer to a uid_t structure that contains a UID.

DESCRIPTION
       The  client  must  have	the PRIV_WIN_DAC_WRITE and PRIV_WIN_MAC_WRITE privileges. The XTSOLsetResUID() function changes the ownership of a
       window system object. This allows a client to create an object and then change its ownership. The new owner can then make modifications	on
       this object as this object being created by itself.

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		   | MT-Unsafe			   |
       +---------------------------+-------------------------------+

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

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 					    XTSOLsetResUID(3XTSOL)