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 window 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), XTSOLgetResLabel(3XTSOL), attributes(5)

Obtaining the Window User ID in Trusted Extensions Developer’s Guide

Notes

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