opensolaris man page for xtsolsetworkstationowner

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

NAME
       XTSOLsetWorkstationOwner - set the ownership of the workstation

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

       Status XTSOLsetWorkstationOwner(display, uidp);

       Display *display;
       uid_t *uidp;
       XTSOLClientAttributes *clientattrp;

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

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

DESCRIPTION
       The  XTSOLsetWorkstationOwner()	function  is  used by the Solaris Trusted Extensions logintool to assign a user ID to be identified as the
       owner of the workstation server. The client running under this user ID can set the server's device objects, such as keyboard mapping, mouse
       mapping, and modifier mapping. The client must have the Trusted Path process attribute.

RETURN VALUES
       None.

ERRORS
       BadAccess    Lack of privilege.

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

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

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

       Accessing and Setting a Workstation Owner 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 				  XTSOLsetWorkstationOwner(3XTSOL)