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)